Skip to main content
GET
/
v1
/
tokens
/
token_info
curl --request GET \
  --url 'https://mach-prod-536329393577.asia-northeast1.run.app/v1/tokens/token_info?chain=arbitrum&token_address=0xff970a61a04b1ca14834a43f5de4533ebddb5cc8'

{
  "chain": "arbitrum",
  "symbol": "USDC",
  "address": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
  "decimals": 6,
  "usd_est": 1,
  "is_wrapped": false,
  "cex_tickers": {
    "binance": "USDC"
  },
  "name": "USD Coin"
}
This endpoint retrieves detailed information about a specific token on a particular blockchain, including its symbol, address, decimals, and other metadata.

​
Query Parameters

​
chain
string
required
Blockchain chain identifier (e.g., “ethereum”, “avalanche”)
​
token_address
string
required
Ethereum token contract address

​
Response

​
chain
string
Blockchain chain identifier
​
symbol
string
Token symbol (e.g., “USDC”)
​
address
string
Token contract address
​
decimals
integer
Token decimal places
​
usd_est
number
Estimated USD value of 1 token unit (can be null)
​
is_wrapped
boolean
Whether the token is a wrapped token
​
cex_tickers
object
Centralized exchange ticker mappings
​
name
string
Token name
curl --request GET \
  --url 'https://mach-prod-536329393577.asia-northeast1.run.app/v1/tokens/token_info?chain=arbitrum&token_address=0xff970a61a04b1ca14834a43f5de4533ebddb5cc8'

{
  "chain": "arbitrum",
  "symbol": "USDC",
  "address": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
  "decimals": 6,
  "usd_est": 1,
  "is_wrapped": false,
  "cex_tickers": {
    "binance": "USDC"
  },
  "name": "USD Coin"
}

​
Status Codes

Status CodeDescription
200Success - Token information returned successfully
422Validation Error - Invalid parameters
500Internal Server Error - Something went wrong on the server