Global Unit
Global Units are units of account available by default in all Entities. There are thirty-six Global Units available to choose from, covering most major currencies.
Any Account or Transaction may be denominated in any Global Unit, and any Ledger, Balance or other derived object may be retrieved in any Global Unit. You can insert, store, and retrieve account information in heterogenous units and Amatino will seamlessly convert units for you.
Each Global Unit has a daily price in every other Global Unit. All prices are closing day prices per the ECB.
If you require a higher temporal resolution than Global Units provide, or a Global Unit does not meet your requirements in some other way, you can create a Custom Unit with your required characteristics. Global Units and Custom Units can be intermingled at will, and Amatino will seamlessly convert between them as required.
The Global Unit Object
Amatino will return Global Unit objects to you with the following structure
Root Type
JSON Array
Object Structure
| type | JSON Number |
| example | 5 |
| key | "global_unit_id" |
| description | The unique integer identifier of this Global Unit |
| type | JSON String |
| example | "usd" |
| key | "code" |
| description | The unique shorthand identifier of this Global Unit |
| type | JSON String |
| example | "United States Dollar" |
| key | "name" |
| description | A friendly long form name |
| type | JSON Number |
| example | 0 |
| key | "priority" |
| description | A sorting hint for GUI's displaying lists of Global Units |
| type | JSON String |
| example | "United States Dollar" |
| key | "description" |
| description | A long-form description |
| type | JSON Number |
| example | 2 |
| key | "exponent" |
| description | The number of digits after the decimal point required to describe the smallest fraction of this Global Unit |
Retrieve Global Unit
| API Path | /units |
| HTTP Method | GET |
| Description Descr. | Retrieve a Global Unit or list of Global Units. |
Required Headers
| Key | X-Signature |
| Value | Your Session signature |
| Example | "yxATCPRKAAXHNiPctNQPHEGGVJF"... |
| Key | X-Session-ID |
| Value | An an integer Session ID |
| Example | 7449059267091272858 |
Required URL Parameters
| Key | global_unit_id |
| Type | number |
| Description Descr. | The unique integer identifier of the Global Unit you wish to retrieve |
| Example | 5 |
| Repeatable | Yes |
Required JSON Data
None.
Returns
Root Type
JSON Array