Rates API

1 endpoint · Public — no authentication required · Sources: Frankfurter (fiat), CoinGecko (crypto)

Supported tickers

Fiat

USD · EUR · INR · JPY · GBP · AUD · CAD · CHF · CNY · HKD · NZD · SEK · NOK · DKK · SGD · ZAR · AED · SAR · MXN · BRL · RUB · KRW · TRY · IDR · THB · PLN · CZK · HUF · ILS · MYR · PHP · PKR · LKR · BDT · NGN

Crypto

BTC · ETH · USDT · XRP · SOL · BNB · USDC · ADA · DOGE · TRX · AVAX · LINK · SHIB · DOT · BCH · LTC · XLM · XMR · NEAR · UNI · APT · ATOM · ALGO · FIL · ETC

POST

/api/v01/rates/search

Fetch exchange rate between any two supported tickers. Fiat-to-fiat uses Frankfurter; any pair involving crypto uses CoinGecko via a USD pivot. This is a public endpoint — no auth token required. Request goes directly as plain JSON, not JWE-encrypted.

Request payload (inside encrypted data {})

Field	Type	Required	Description
ticker1	string	yes	Source ticker (e.g. 'USD', 'BTC')
ticker2	string	yes	Target ticker (e.g. 'INR', 'USDT')

Response data {}

Field	Type	Required	Description
ticker1	string	no	Normalised source ticker (uppercase)
ticker2	string	no	Normalised target ticker (uppercase)
rate	number	no	Units of ticker2 per 1 ticker1
time	number	no	Rate fetch timestamp (ms)

Request Payload

Request data — fiat to fiat

{
  "ticker1": "USD",
  "ticker2": "INR"
}

Response Data

200 OK — fiat to fiat

{
  "data": {
    "ticker1": "USD",
    "ticker2": "INR",
    "rate": 83.42,
    "time": 1700000000000
  },
  "memo": "Rate fetched successfully.",
  "stat": true,
  "code": 200,
  "time": 1700000000000,
  "trxn": "a3f2c1b4d5e6f7a8b9c0d1e2f3a4b5c6",
  "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6"
}

200 OK — crypto to fiat

{
  "data": {
    "ticker1": "BTC",
    "ticker2": "USD",
    "rate": 67450.12,
    "time": 1700000000000
  },
  "memo": "Rate fetched successfully.",
  "stat": true,
  "code": 200,
  "time": 1700000000000,
  "trxn": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
  "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6"
}

400 — Tickers required

{
  "data": {},
  "memo": "data.ticker1 and data.ticker2 are required.",
  "stat": false,
  "code": 400,
  "time": 1700000000000,
  "trxn": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
  "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6"
}

422 — Unable to compute rate

{
  "data": {},
  "memo": "Unable to compute exchange rate for this pair.",
  "stat": false,
  "code": 422,
  "time": 1700000000000,
  "trxn": "f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
  "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6"
}

← Transfers ← Back to API ReferenceEnd of reference

Field

Type

Required

Description

ticker1

string

yes

Source ticker (e.g. 'USD', 'BTC')

ticker2

string

yes

Target ticker (e.g. 'INR', 'USDT')

Field

Type

Required

Description

ticker1

string

Normalised source ticker (uppercase)

ticker2

string

Normalised target ticker (uppercase)

rate

number

Units of ticker2 per 1 ticker1

time

number

Rate fetch timestamp (ms)

{ "data": { "ticker1": "USD", "ticker2": "INR", "rate": 83.42, "time": 1700000000000 }, "memo": "Rate fetched successfully.", "stat": true, "code": 200, "time": 1700000000000, "trxn": "a3f2c1b4d5e6f7a8b9c0d1e2f3a4b5c6", "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6" }

{ "data": { "ticker1": "BTC", "ticker2": "USD", "rate": 67450.12, "time": 1700000000000 }, "memo": "Rate fetched successfully.", "stat": true, "code": 200, "time": 1700000000000, "trxn": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9", "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6" }

{ "data": {}, "memo": "data.ticker1 and data.ticker2 are required.", "stat": false, "code": 400, "time": 1700000000000, "trxn": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0", "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6" }

{ "data": {}, "memo": "Unable to compute exchange rate for this pair.", "stat": false, "code": 422, "time": 1700000000000, "trxn": "f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1", "srvc": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6" }