Fetch Chain Currencies

curl --request GET \
  --url https://secureapi.tender.cash/v1/api/system/chains/{id}/currency \
  --header 'x-access-id: <api-key>'

const options = {method: 'GET', headers: {'x-access-id': '<api-key>'}};

fetch('https://secureapi.tender.cash/v1/api/system/chains/{id}/currency', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://secureapi.tender.cash/v1/api/system/chains/{id}/currency",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-access-id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": "success",
  "message": "success",
  "data": [
    {
      "id": "usdt",
      "name": "USDT",
      "icon": "<string>",
      "symbol": "USDT",
      "status": "active",
      "isContract": true,
      "chains": [
        "<string>"
      ],
      "priceTag": "tether",
      "fee": {},
      "contractAddress": {},
      "priority": 123
    }
  ]
}

{
  "status": "error",
  "message": "INVALID_REQUEST_SIGNATURE",
  "data": {}
}

{
  "status": "error",
  "message": "Too many requests. Max 120 per 60s.",
  "data": null
}

GET

api

system

chains

{id}

currency

Fetch Chain Currencies

curl --request GET \
  --url https://secureapi.tender.cash/v1/api/system/chains/{id}/currency \
  --header 'x-access-id: <api-key>'

const options = {method: 'GET', headers: {'x-access-id': '<api-key>'}};

fetch('https://secureapi.tender.cash/v1/api/system/chains/{id}/currency', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://secureapi.tender.cash/v1/api/system/chains/{id}/currency",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-access-id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": "success",
  "message": "success",
  "data": [
    {
      "id": "usdt",
      "name": "USDT",
      "icon": "<string>",
      "symbol": "USDT",
      "status": "active",
      "isContract": true,
      "chains": [
        "<string>"
      ],
      "priceTag": "tether",
      "fee": {},
      "contractAddress": {},
      "priority": 123
    }
  ]
}

{
  "status": "error",
  "message": "INVALID_REQUEST_SIGNATURE",
  "data": {}
}

{
  "status": "error",
  "message": "Too many requests. Max 120 per 60s.",
  "data": null
}

Auth method: Basic (Access ID) — this endpoint only requires your x-access-id header. No request signing is needed. See Authentication.

Returns the active currencies (cryptocurrencies) available on one chain. The response contains at most 12 currencies, sorted by priority (lowest first); currencies without a priority come last. This list isn’t narrowed to your outlet’s allowed currencies. To see only the currencies your outlet accepts, use Fetch All Currencies with chains=<chain id>. System endpoints share a limit of 120 requests per minute. See Rate limits.

Path Parameters

string

required

Chain identifier, as returned by Fetch Allowed ChainsExample: "avalanche"

Headers

string

required

Your API access ID provided by TenderExample: "your-access-id-here"

Response

string

required

Status of the API requestExample: "success"

string

required

Human-readable message describing the resultExample: "success"

array

required

Array of currencies supported on the specified chain

Show currency object

string

Unique identifier for the currencyExample: "avalanche"

string

Display name of the currencyExample: "Avax"

string

URL to the currency’s icon imageExample: "https://tender-store.s3.amazonaws.com/icons/avax.png"

string

Currency symbolExample: "AVAX"

string

Current status of the currencyExample: "active"

boolean

Whether this is a smart contract tokenExample: false

array

Array of chain identifiers where this currency is availableExample: ["avalanche"]

string

Price identifier for market dataExample: "avalanche-2"

object

Fee configuration per chain (chain id to fee string)Example: { "avalanche": "5" }

object

Smart contract addresses per chain when isContract is true (chain id to address)Example: { "avalanche": "0x5425890298aed601595a70AB815c96711a31Bc65", "ethereum": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238" }

number

Display order; lower values first. Omitted when not set.Example: 1

Example response

{
  "status": "success",
  "message": "success",
  "data": [
    {
      "id": "avalanche",
      "name": "Avax",
      "icon": "https://tender-store.s3.amazonaws.com/icons/avax.png",
      "symbol": "AVAX",
      "status": "active",
      "isContract": false,
      "chains": ["avalanche"],
      "priceTag": "avalanche-2",
      "fee": { "avalanche": "5" },
      "priority": 1
    },
    {
      "id": "usdc",
      "name": "USDC",
      "icon": "https://tender-store.s3.amazonaws.com/icons/usdc.png",
      "symbol": "USDC",
      "status": "active",
      "isContract": true,
      "chains": ["avalanche", "ethereum", "optimism", "aurora", "near", "polygon", "solana", "base", "beam", "stellar", "tron", "8453"],
      "priceTag": "usd-coin",
      "fee": { "ethereum": "25", "optimism": "3", "avalanche": "3", "polygon": "3", "solana": "3", "stellar": "3", "base": "5", "beam": "5", "tron": "3" },
      "contractAddress": {
        "avalanche": "0x5425890298aed601595a70AB815c96711a31Bc65",
        "ethereum": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
        "optimism": "0xA6d3287496f7d3f1F20521141161448D15393b67",
        "polygon": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
        "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "stellar": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "tron": "TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8",
        "base": "0x53D85F1925fCE8BB93732ed969800Df0b062258A"
      },
      "priority": 2
    },
    {
      "id": "usdt",
      "name": "USDT",
      "icon": "https://tender-store.s3.amazonaws.com/icons/usdt.png",
      "symbol": "USDT",
      "status": "active",
      "isContract": true,
      "chains": ["avalanche", "ethereum", "optimism", "aurora", "near", "polygon", "solana", "tron", "pego"],
      "priceTag": "tether",
      "fee": { "ethereum": "25", "optimism": "3", "avalanche": "3", "polygon": "3", "solana": "3", "tron": "3", "pego": "3" },
      "contractAddress": {
        "avalanche": "0xa1Ef10416440A13D555B9Dc78F81153D13340588",
        "ethereum": "0xFcF3950CFB1aCA9a7733839967126799A4D10fdF",
        "optimism": "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58",
        "polygon": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
        "solana": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "tron": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "pego": "0x02F9Bebf5E54968D8Cc2562356C91ECDE135801B"
      },
      "priority": 3
    }
  ]
}

Authorizations

x-access-id

string

header

required

Basic (Access ID) authentication. Only the x-access-id header is required; no request signing.

Headers

x-access-id

string

required

Your API access ID provided by Tender

Path Parameters

string

required

Chain identifier

Response

Currencies

status

string

Example:

"success"

message

string

Example:

"success"

data

object[]

Maximum array length: 12

Show child attributes

Payment

Transactions

System

Agents

Conversions

Payouts

Subwallets

Webhooks

On-ramp

Fetch Chain Currencies

Path Parameters

Headers

Response

Example response

Authorizations

Headers

Path Parameters

Response

​Path Parameters

​Headers

​Response

​Example response

Authorizations

Headers

Path Parameters

Response

Path Parameters

Headers

Response

Example response