Currencies
The Currencies API provides information about supported currencies for invoice creation.
Endpoints
Get Supported Currencies
Retrieves a list of all supported currencies.
Endpoint: GET /api/v1/currencies
Authentication: None
Response:
JSON
1 [ 2 { 3 "code": "USD", 4 "name": "US Dollar", 5 "is_fiat": true, 6 "decimal_places": 2, 7 "min_amount": "0.01", 8 "max_amount": "25000.00" 9 }, 10 { 11 "code": "EUR", 12 "name": "Euro", 13 "is_fiat": true, 14 "decimal_places": 2, 15 "min_amount": "0.01", 16 "max_amount": "25000.00" 17 }, 18 { 19 "code": "XNO", 20 "name": "Nano", 21 "is_fiat": false, 22 "decimal_places": 30, 23 "min_amount": "0.000001", 24 "max_amount": "25000.00" 25 } 26 ]
Currency Properties
| Property | Description |
|---|---|
| code | The currency code (e.g., USD, EUR, NANO) |
| name | The full name of the currency |
| is_fiat | Whether the currency is a fiat currency |
| decimal_places | The number of decimal places supported |
| min_amount | The minimum amount that can be used in an invoice |
| max_amount | The maximum amount that can be used in an invoice |
Using Currencies
When creating an invoice, you can specify the nominal_currency parameter to set the currency for the invoice. The API will automatically convert the amount to Nano using the current exchange rate.
Example:
JSON
1 { 2 "nominal_amount": 10.00, 3 "nominal_currency": "USD", 4 "destinations": [ 5 { 6 "account": "nano_1abc...", 7 "primary": true 8 } 9 ] 10 }
This will create an invoice for $10.00 USD, converted to the equivalent amount in Nano.