Search Currencies

Search currencies

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
}
'

import requests

url = "https://godirekt.xyz/api/currencies"

payload = {
    "chainIds": [56],
    "address": "0x55d398326f99059ff775485246999027b3197955",
    "term": "usdt",
    "verified": True,
    "limit": 20,
    "defaultList": True,
    "includeAllChains": True,
    "useExternalSearch": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chainIds: [56],
    address: '0x55d398326f99059ff775485246999027b3197955',
    term: 'usdt',
    verified: true,
    limit: 20,
    defaultList: true,
    includeAllChains: true,
    useExternalSearch: true
  })
};

fetch('https://godirekt.xyz/api/currencies', 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://godirekt.xyz/api/currencies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chainIds' => [
        56
    ],
    'address' => '0x55d398326f99059ff775485246999027b3197955',
    'term' => 'usdt',
    'verified' => true,
    'limit' => 20,
    'defaultList' => true,
    'includeAllChains' => true,
    'useExternalSearch' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://godirekt.xyz/api/currencies"

	payload := strings.NewReader("{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://godirekt.xyz/api/currencies")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://godirekt.xyz/api/currencies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}"

response = http.request(request)
puts response.read_body

{
  "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
      }
    }
  ]
}

POST

api

currencies

Search currencies

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
}
'

import requests

url = "https://godirekt.xyz/api/currencies"

payload = {
    "chainIds": [56],
    "address": "0x55d398326f99059ff775485246999027b3197955",
    "term": "usdt",
    "verified": True,
    "limit": 20,
    "defaultList": True,
    "includeAllChains": True,
    "useExternalSearch": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chainIds: [56],
    address: '0x55d398326f99059ff775485246999027b3197955',
    term: 'usdt',
    verified: true,
    limit: 20,
    defaultList: true,
    includeAllChains: true,
    useExternalSearch: true
  })
};

fetch('https://godirekt.xyz/api/currencies', 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://godirekt.xyz/api/currencies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chainIds' => [
        56
    ],
    'address' => '0x55d398326f99059ff775485246999027b3197955',
    'term' => 'usdt',
    'verified' => true,
    'limit' => 20,
    'defaultList' => true,
    'includeAllChains' => true,
    'useExternalSearch' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://godirekt.xyz/api/currencies"

	payload := strings.NewReader("{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://godirekt.xyz/api/currencies")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://godirekt.xyz/api/currencies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chainIds\": [\n    56\n  ],\n  \"address\": \"0x55d398326f99059ff775485246999027b3197955\",\n  \"term\": \"usdt\",\n  \"verified\": true,\n  \"limit\": 20,\n  \"defaultList\": true,\n  \"includeAllChains\": true,\n  \"useExternalSearch\": true\n}"

response = http.request(request)
puts response.read_body

{
  "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[]

​Search by term

​Search by contract address

​Response fields

Authorizations

Body

Response

Search by term

Search by contract address

Response fields