Retrieve detailed information about a specific token

Retrieves detailed information for a specific token identified by its contract address.

GET /v2/tokens/{address_hash_param}

Retrieve detailed information about a specific token

cURL

curl --request GET \
  --url http://localhost/api/v2/tokens/{address_hash_param}

200

{
  "address_hash": "<string>",
  "circulating_market_cap": "<string>",
  "decimals": "<string>",
  "exchange_rate": "<string>",
  "holders_count": "<string>",
  "icon_url": "https://example.com",
  "name": "<string>",
  "symbol": "<string>",
  "total_supply": "<string>",
  "volume_24h": "<string>",
  "foreign_address": "<string>",
  "origin_chain_id": "<string>"
}

Path Parameters

address_hash_param · string · required

Address hash in the path

Pattern: ^0x([A-Fa-f0-9]{40})$

Query Parameters

apikey · string

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

Response

200

application/json

Detailed information about the specified token.

Token response

address_hash · string · required

Pattern: ^0x([A-Fa-f0-9]{40})$

circulating_market_cap · string | null · required

Pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$

decimals · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

exchange_rate · string | null · required

Pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$

holders_count · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

icon_url · string<uri> | null · required

Example:

"https://example.com"

name · string | null · required

reputation · enum<string> | null · required

Reputation of the token

Available options: ok, scam

symbol · string | null · required

total_supply · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

type · enum<string> · required

Available options: ERC-20, ERC-721, ERC-1155, ERC-404, ERC-7984

volume_24h · string | null · required

Pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$

bridge_type · enum<string> | null

Type of bridge used for this bridged token

Available options: omni, amb

foreign_address · string | null

Pattern: ^0x([A-Fa-f0-9]{40})$

origin_chain_id · string | null

Pattern: ^-?([1-9][0-9]*|0)$