Token Data API

Get Trending Tokens

get

Returns the top trending tokens across all supported chains.

Responses

200

A list of trending token objects.

application/json

get

/tokens/trending

HTTPcURLJavaScriptPython

GET /v1/tokens/trending HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

A list of trending token objects.

[
  {
    "symbol": "text",
    "address": "text",
    "name": "text",
    "logo": "text"
  }
]

Search Tokens

get

Search for tokens by name, symbol, or contract address.

Query parameters

querystringRequired

The search term (token name, symbol, or address).

Responses

200

A list of matching token objects.

application/json

get

/tokens/search

HTTPcURLJavaScriptPython

GET /v1/tokens/search?query=text HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

A list of matching token objects.

[
  {
    "symbol": "text",
    "address": "text",
    "name": "text",
    "logo": "text"
  }
]

Get Token Metadata

get

Fetch detailed metadata for a token on the specified chain.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

addressstringRequired

The contract address of the token.

Responses

200

Token metadata object.

application/json

get

/tokens/{chain}/{address}

HTTPcURLJavaScriptPython

GET /v1/tokens/{chain}/{address} HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Token metadata object.

{
  "symbol": "text",
  "name": "text",
  "decimals": 1,
  "logo": "text",
  "description": "text"
}

List Token Pairs

get

Retrieve all trading pairs for a given token on the specified chain.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

tokenAddressstringRequired

The token contract address.

Responses

200

Array of pair objects.

application/json

get

/pairs/{chain}/{tokenAddress}

HTTPcURLJavaScriptPython

GET /v1/pairs/{chain}/{tokenAddress} HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Array of pair objects.

[
  {
    "pairAddress": "text",
    "token0": {
      "symbol": "text",
      "address": "text",
      "name": "text",
      "logo": "text"
    },
    "token1": {
      "symbol": "text",
      "address": "text",
      "name": "text",
      "logo": "text"
    }
  }
]

Get Pair Stats

get

Retrieve price, volume, liquidity and other statistics for a trading pair.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

pairAddressstringRequired

The pair contract address.

Responses

200

Pair statistics object.

application/json

get

/pairs/{chain}/{pairAddress}/stats

HTTPcURLJavaScriptPython

GET /v1/pairs/{chain}/{pairAddress}/stats HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Pair statistics object.

{
  "currentPrice": 1,
  "volume": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "liquidity": 1
}

Get Pair Swaps

get

Fetch swap transaction history for a trading pair.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

pairAddressstringRequired

The pair contract address.

Responses

200

Array of swap transaction objects.

application/json

get

/pairs/{chain}/{pairAddress}/swaps

HTTPcURLJavaScriptPython

GET /v1/pairs/{chain}/{pairAddress}/swaps HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Array of swap transaction objects.

[
  {
    "transactionHash": "text",
    "timestamp": "2026-01-08T21:38:44.372Z",
    "amount0": 1,
    "amount1": 1
  }
]

Get Pair Snipers

get

Identify early buyer/sniper bot transactions for a new pair.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

pairAddressstringRequired

The pair contract address.

Responses

200

Array of sniper transaction objects.

application/json

get

/pairs/{chain}/{pairAddress}/snipers

HTTPcURLJavaScriptPython

GET /v1/pairs/{chain}/{pairAddress}/snipers HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Array of sniper transaction objects.

[
  {
    "transactionHash": "text",
    "timestamp": "2026-01-08T21:38:44.372Z",
    "amount0": 1,
    "amount1": 1
  }
]

List Token Holders

get

List all holders and their balances for a given token.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

tokenAddressstringRequired

The token contract address.

Responses

200

Array of holder objects.

application/json

get

/holders/{chain}/{tokenAddress}

HTTPcURLJavaScriptPython

GET /v1/holders/{chain}/{tokenAddress} HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Array of holder objects.

[
  {
    "address": "text",
    "balance": 1
  }
]

Get Token Holder Stats

get

Retrieve aggregated holder distribution and statistics.

Path parameters

chainstringRequired

Blockchain identifier (e.g., eth, bsc, polygon, arbitrum, etc.).

tokenAddressstringRequired

The token contract address.

Responses

200

Holder statistics object.

application/json

get

/holders/{chain}/{tokenAddress}/stats

HTTPcURLJavaScriptPython

GET /v1/holders/{chain}/{tokenAddress}/stats HTTP/1.1
Host: api.atlaterminal.io
Accept: */*

200

Holder statistics object.

{
  "totalHolders": 1,
  "topHolderPercentage": 1,
  "distribution": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "topHolders": [
    {
      "address": "text",
      "balance": 1
    }
  ]
}