Skip to main content
GET
/
tokens
/
{token_address}
Get token metadata by address
curl --request GET \
  --url https://api-testnet.gte.xyz/v1/tokens/{token_address}
{
  "address": "<string>",
  "decimals": 123,
  "name": "<string>",
  "symbol": "<string>",
  "totalSupply": 123,
  "logoUri": "<string>",
  "priceUsd": 123,
  "volume1HrUsd": 123,
  "volume24HrUsd": 123,
  "marketCapUsd": 123,
  "marketType": "bonding-curve",
  "createdAt": 123,
  "numHolders": 1,
  "creator": "<string>",
  "description": "<string>",
  "displayMarkets": [
    {
      "marketType": "bonding-curve",
      "marketAddress": "<string>"
    }
  ],
  "socials": {
    "website": "<string>",
    "discord": "<string>",
    "telegram": "<string>",
    "x": "<string>"
  }
}

Path Parameters

token_address
string
required

EVM address

Response

Token details

address
string
required

EVM address

decimals
integer
required

Number of decimals for the token

name
string
required

Name of the token

symbol
string
required

Symbol of the token

totalSupply
number
required

Total supply of the token

logoUri
string | null
required

URI of the token's logo

priceUsd
number
required

Price of token in USD

volume1HrUsd
number
required

1 hour volume in USD

volume24HrUsd
number
required

24 hour volume in USD

marketCapUsd
number
required

Token market cap in USD

createdAt
integer
required

Timestamp of the token creation

numHolders
integer
required

Number of holders of the token

Required range: x >= 0
creator
string
required

EVM address

description
string | null
required

Token description

displayMarkets
object[]
required

Top markets to display per market type

socials
object
required
marketType
enum<string>

Highest market type that the token is listed in

Available options:
bonding-curve,
amm,
clob-spot,
perps
I