Currency and Network References for Selection

OpenAPI block

References are formed based on merchant networks and currencies added to the system.

In the database, a configured entity represents a currency/network pair.

Response (200 OK):

Field	Type	Description
currencies	Array	List of currency objects

Currencies Object Fields

Field	Type	Description
blockchain	String	Network name (e.g., Tron)
contractAddress	String	Token contract address
tokenSymbol	String	Token symbol (USDT)

Example

GET /v1/reference/currencies
Date: Tue, 09 Apr 2025 12:00:00 GMT
Authorization: HMAC merchant_001:abc123xyz456

Response

Ok

{
  "offset": 0,
  "limit": 10,
  "count": 2,
  "data": [
    {
      "blockchain": "Eth",
      "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "tokenSymbol": "USDT"
    },
   
    {
      "blockchain": "TRON",
      "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "tokenSymbol": "USDT"
    }
  ]
}

Errors:

All methods return a unified error format:

Code	Error Description	Details
400	Bad request (missing parameter, invalid Date, etc.)	{"error": {"code": "bad_request", "message": "Invalid date header"}}
401	Authorization error (missing or invalid signature)	{"error": {"code": "unauthorized", "message": "Authorization header missing or invalid signature"}}
403	Access denied	{"error": {"code": "forbidden", "message": "Access to this resource is denied"}}
404	Resource not found	{"error": {"code": "not_found", "message": "Resource not found"}}
500	Internal server error	{"error": {"code": "internal_error", "message": "An unexpected error occurred"}}
503	Service unavailable (external dependencies)	{"error": {"code": "service_unavailable", "message": "Temporary overload or maintenance"}}

Notes

• The currencies reference is formed based on data available to a specific merchant, identified via merchant_id from the Authorization header.

• The method returns only active networks and currencies available to the merchant.