List Currencies

Retrieves a list of available currencies with their details including exchange rates and currency types (fiat/crypto).

Endpoint

GET/v2/currency

Link

Gateway APIstagep.tst-apidmndelss.com

Request

Headers

Key	Value	Required
Authorization	Bearer <JWT>	Yes
Accept	application/json	Yes

---

Response (200 OK)

Returns an array of currency objects with detailed information.

Response Fields

Currency Object

Field	Type	Description	Example
iso	string	ISO 4217 currency code (3-letter).	"USD"
name	string	Full currency name.	"US Dollar"
isCrypto	boolean	true for cryptocurrencies.	false
isDefault	boolean	true for system default currency.	true
rate	number	Exchange rate relative to default currency.	1.0

Example Response:

json

{
  "items": [
    {
      "iso": "USD",
      "name": "US Dollar",
      "isCrypto": false,
      "isDefault": true,
      "rate": 1.0
    },
    {
      "iso": "EUR",
      "name": "Euro",
      "isCrypto": false,
      "isDefault": false,
      "rate": 0.93
    },
    {
      "iso": "BTC",
      "name": "Bitcoin",
      "isCrypto": true,
      "isDefault": false,
      "rate": 0.000025
    }
  ]
}

---

Error Responses

1. Unauthorized:

   json

   {
     "error": "Unauthorized"
   }

---

Notes

• Rate Basis:

  • Exchange rates are relative to the default currency (e.g., isDefault: true).
  • Example: If USD is default, EUR rate 0.93 means 1 USD = 0.93 EUR.
• Crypto Currencies:

  • Cryptocurrencies use standard ticker symbols (e.g., BTC, ETH).
  • Rates may update frequently due to market volatility.
• Default Currency:

  • Typically used as the base for accounting and reporting.
  • Only one currency can be default per system.

Examples

Real request

Authorization:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjE2NCwiZXhwIjoxNzYxMTMwMzU1LCJrZXkiOiI1Y2ZiOGZjN2RmYjk4ZjVkYmIyZTgwNTVkZWFhN2U2Zjk4MzEyYmE3Iiwib3RwX3ZlcmlmaWVkIjpmYWxzZX0.yzC3XkfbHdA2IWiS_wPTgFiVD1O-nEt48f8ULJn50pk

Real response

200 OK

{
  "items": [
    {
      "code": "AED",
      "name": "AED",
      "isCrypto": false,
      "isDefault": false,
      "rate": 3.6725
    },
    {
      "code": "BHD",
      "name": "BHD",
      "isCrypto": false,
      "isDefault": false,
      "rate": 0.37701
    },
    {
      "code": "BRL",
      "name": "BRL",
      "isCrypto": false,
      "isDefault": false,
      "rate": 5.3878
    },
    {
      "code": "BSD",
      "name": "BSD",
      "isCrypto": false,
      "isDefault": false,
      "rate": 1
    },
    {
      "code": "BTC",
      "name": "BTC",
      "isCrypto": true,
      "isDefault": false,
      "rate": 0.00000925755
    },
    {
      "code": "CAD",
      "name": "CAD",
      "isCrypto": false,
      "isDefault": false,
      "rate": 1.401228
    },
    {
      "code": "CHF",
      "name": "CHF",
      "isCrypto": false,
      "isDefault": false,
      "rate": 0.796247
    },
    {
      "code": "CNY",
      "name": "CNY",
      "isCrypto": false,
      "isDefault": false,
      "rate": 7.1248
    },
    {
      "code": "CRC",
      "name": "CRC",
      "isCrypto": false,
      "isDefault": false,
      "rate": 502.4538
    },
    {
      "code": "DKK",
      "name": "DKK",
      "isCrypto": false,
      "isDefault": false,
      "rate": 6.441807
    },
    {
      "code": "ETH",
      "name": "ETH",
      "isCrypto": true,
      "isDefault": false,
      "rate": 0.00026048927
    },
    {
      "code": "EUR",
      "name": "EUR",
      "isCrypto": false,
      "isDefault": false,
      "rate": 0.86159354
    },
    {
      "code": "GBP",
      "name": "GBP",
      "isCrypto": false,
      "isDefault": false,
      "rate": 0.750792
    },
    {
      "code": "GTQ",
      "name": "GTQ",
      "isCrypto": false,
      "isDefault": false,
      "rate": 7.667817
    },
    {
      "code": "HKD",
      "name": "HKD",
      "isCrypto": false,
      "isDefault": false,
      "rate": 7.769675
    },
    {
      "code": "INR",
      "name": "INR",
      "isCrypto": false,
      "isDefault": false,
      "rate": 87.75751
    },
    {
      "code": "JPY",
      "name": "JPY",
      "isCrypto": false,
      "isDefault": false,
      "rate": 151.8205
    },
    {
      "code": "MATIC",
      "name": "MATIC",
      "isCrypto": true,
      "isDefault": false,
      "rate": 5.0125313
    },
    {
      "code": "MXN",
      "name": "MXN",
      "isCrypto": false,
      "isDefault": false,
      "rate": 18.400436
    },
    {
      "code": "MYR",
      "name": "MYR",
      "isCrypto": false,
      "isDefault": false,
      "rate": 4.23
    },
    {
      "code": "PAB",
      "name": "PAB",
      "isCrypto": false,
      "isDefault": false,
      "rate": 1
    },
    {
      "code": "PLN",
      "name": "PLN",
      "isCrypto": false,
      "isDefault": false,
      "rate": 3.651135
    },
    {
      "code": "QAR",
      "name": "QAR",
      "isCrypto": false,
      "isDefault": false,
      "rate": 3.648913
    },
    {
      "code": "SAR",
      "name": "SAR",
      "isCrypto": false,
      "isDefault": false,
      "rate": 3.750313
    },
    {
      "code": "SGD",
      "name": "SGD",
      "isCrypto": false,
      "isDefault": false,
      "rate": 1.298656
    },
    {
      "code": "SOL",
      "name": "SOL",
      "isCrypto": true,
      "isDefault": false,
      "rate": 0.0054306504
    },
    {
      "code": "TRL",
      "name": "TRL",
      "isCrypto": false,
      "isDefault": false,
      "rate": 1
    },
    {
      "code": "TRX",
      "name": "TRX",
      "isCrypto": true,
      "isDefault": false,
      "rate": 3.0854676
    },
    {
      "code": "USD",
      "name": "USD",
      "isCrypto": false,
      "isDefault": true,
      "rate": 1
    },
    {
      "code": "USDC_ERC20",
      "name": "USDC ERC20",
      "isCrypto": true,
      "isDefault": false,
      "rate": 1
    },
    {
      "code": "USDT_ERC20",
      "name": "USDT ERC20",
      "isCrypto": true,
      "isDefault": false,
      "rate": 1
    },
    {
      "code": "USDT_TRC20",
      "name": "USDT TRC20",
      "isCrypto": true,
      "isDefault": false,
      "rate": 1
    }
  ]
}