Skip to main content
GET
/
api
/
v1
/
token-info
token-info
curl --request GET \
  --url https://api.naos.trade/api/v1/token-info \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "tokenInfo": {
    "token": {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "totalSupply": "<string>"
    },
    "chain": "<string>"
  },
  "poolInfo": {
    "address": "<string>",
    "type": "<string>",
    "factory": "<string>",
    "fee": 123,
    "tickSpacing": 123,
    "hooks": "<string>",
    "router": "<string>",
    "quoter": "<string>",
    "liquidity": 123,
    "liquidityNative": 123,
    "marketCap": 123,
    "priceNative": 123,
    "createdAt": 123,
    "token": {},
    "quote": {},
    "chain": "<string>"
  },
  "misc": {
    "buyTax": 123,
    "sellTax": 123,
    "transferTax": 123,
    "maxTx": 123,
    "maxBuyInput": "<string>",
    "inputCurrency": "<string>",
    "inputDecimals": 123,
    "clogged": "<string>",
    "burnt": "<string>",
    "buyFeeUsd": 123,
    "sellFeeUsd": 123
  },
  "activity": {
    "volume30d": 123,
    "gasFeesUsd30d": 123,
    "gasFeesUsdAllTime": 123
  },
  "ath": {
    "priceUsd": 123,
    "priceNative": 123,
    "marketCapUsd": 123,
    "at": 123,
    "block": 123
  },
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

API key via Authorization: Bearer YOUR_API_KEY

Query Parameters

token
string
required

Token contract address

chain
enum<string>

Blockchain network (auto-detected if omitted) Blockchain network identifier

Available options:
BASE,
ETH,
BSC,
ARB,
AVAX,
ABS,
HYPE,
INK,
STORY,
XLAYER,
PLASMA,
UNI,
MONAD,
MEGAETH,
SOL
audit
enum<string>
default:true

Include security audit data (false to skip and improve response time)

Available options:
true,
false
extended
enum<string>
default:false

Include extended on-chain activity signals (volume30d, gasFeesUsd30d, gasFeesUsdAllTime). EVM only — Solana returns null fields. Default false.

Available options:
true,
false
ath
enum<string>
default:false

Include all-time-high price + market cap. EVM: derived from the token's current pool with 30s candle close + HAVING ≥ 3 swaps (BeBot-aligned, MEV / sandwich filtered). Solana: pulled from Mobula's aggregated /api/1/market/data.ath (cross-DEX). priceNative and at are null on Solana. Cached server-side for 60s. Default false.

Available options:
true,
false

Response

Token info retrieved

success
boolean
required
tokenInfo
object
poolInfo
object
misc
object
activity
object

Only present when extended=true in the query. Aggregated signals over the last 30 days from on-chain swap data. EVM only — Solana fields are null.

ath
object

Only present when ath=true in the query. All-time-high price + market cap. EVM: derived from the token's CURRENT pool (the same pool surfaced in poolInfo) using defi.swaps, BeBot-aligned formula. Solana: pulled from Mobula's /api/1/market/data.ath field (cross-DEX aggregated). Cached server-side for 60s. Both surfaces share the same response shape; priceNative and at are null on Solana.

error
string | null