Search Currencies

Search for tokens by address, symbol, or chain.

POST /api/currencies

Search currencies

cURL

curl --request POST \
  --url https://godirekt.xyz/api/currencies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "chainIds": [
    56
  ],
  "address": "0x55d398326f99059ff775485246999027b3197955",
  "term": "usdt",
  "verified": true,
  "limit": 20,
  "defaultList": true,
  "includeAllChains": true,
  "useExternalSearch": true
}
'

200

{
  "success": true,
  "currencies": [
    {
      "chainId": 56,
      "address": "0x55d398326f99059ff775485246999027b3197955",
      "symbol": "USDT",
      "name": "Tether USD",
      "decimals": 18,
      "vmType": "evm",
      "metadata": {
        "logoURI": "https://coin-images.coingecko.com/coins/images/39963/large/usdt.png",
        "verified": true
      }
    }
  ]
}

Search for any token by address, name, or symbol across supported chains.

Search by term

curl --location 'https://godirekt.xyz/api/currencies' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chainIds": [56],
    "term": "usdt",
    "verified": true,
    "limit": 20,
    "useExternalSearch": true
  }'

Response:

{
  "success": true,
  "currencies": [
    {
      "chainId": 56,
      "address": "0x55d398326f99059ff775485246999027b3197955",
      "symbol": "USDT",
      "name": "Tether USD",
      "decimals": 18,
      "vmType": "evm",
      "metadata": {
        "logoURI": "https://coin-images.coingecko.com/coins/images/39963/large/usdt.png",
        "verified": true
      }
    }
  ]
}

Search by contract address

curl --location 'https://godirekt.xyz/api/currencies' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chainIds": [56],
    "address": "0x6B6f93a12705b6eB60490A8b8a9aC15b3B1ce0f2",
    "limit": 20,
    "useExternalSearch": true
  }'

Response:

{
  "success": true,
  "currencies": [
    {
      "chainId": 56,
      "address": "0x6b6f93a12705b6eb60490a8b8a9ac15b3b1ce0f2",
      "symbol": "SNR",
      "name": "StableNaira",
      "decimals": 2,
      "vmType": "evm",
      "metadata": {
        "logoURI": "https://assets.geckoterminal.com/bwa1ujpgkc562s8zewby73jmnekc",
        "verified": false
      }
    }
  ]
}

Response fields

Field	Description
chainId	Chain the token lives on
address	Token contract address
symbol	Token ticker (e.g. USDT)
name	Full token name
decimals	Token decimal places
vmType	VM type: evm, svm, tvm etc.
metadata.verified	Whether the token is verified
metadata.logoURI	Token logo image URL

Authorizations

x-api-key · string · header · required

Body

application/json

chainIds · integer[]

Filter by chain IDs

Example:

[56]

address · string

Token contract address

Example:

"0x55d398326f99059ff775485246999027b3197955"

term · string

Search by symbol or name

Example:

"usdt"

verified · boolean

Only return verified tokens

Example:

true

limit · integer

Max results (default 20, max 100)

Example:

20

defaultList · boolean

Return default currency list

includeAllChains · boolean

Include all chains for matched token

useExternalSearch · boolean

Use 3rd party APIs for unlisted tokens

Example:

true

Response

200 - application/json

Matching currencies

success · boolean

currencies · object[]