Find Token By Address

Looks up a token by its on-chain contract address and returns a compact summary: name, symbol, image, current price and network. The address match is case-insensitive. The lookup covers every token on the platform with that contract address, not only distribution tokens, and is not limited to the caller's node.

Required permission: distribution:view

Request

GET /v2/distributions/tokens/addresses/{address}

Parameters

Name	Type	In	Description
address	string	path	Required. The token's contract address

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/distributions/tokens/addresses/0x073c0196e516a0e77b1c804d1825fb1bad23895d' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d",
  "name": "Istanbul Commercial Lease #1",
  "symbol": "ICL",
  "decimal": 18,
  "image": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/cover.png",
  "price": {
    "id": "6913307ec95e268b239b2d8b",
    "amount": "100",
    "decimal": 6,
    "symbol": "USDT",
    "address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
  },
  "network_id": 137
}

Response Fields

Field	Type	Description
address	string	The token's contract address
name	string	On-chain token name
symbol	string	Token symbol
decimal	integer	Token decimals. Always 18
image	string	URL of the token's first active image. Empty when it has none
price	object	Unit price of one token
price.id	string	Id of the currency token the price is quoted in
price.amount	string	Price per token, a decimal string (see Amounts and Percentages)
price.decimal	integer	Decimals of the currency token
price.symbol	string	Symbol of the currency token
price.address	string	Contract address of the currency token
network_id	integer	EVM chain id of the token's network (e.g. 137 Polygon), not the catalog id used in request bodies (see Get Networks). 0 when the token has no network

Errors

Status	Code	Description
400	10001	No token has this contract address (domain 5, message token not found)
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.