Enter App ->

Token Data

The Token Data endpoints provide detailed insights into tokens across the Solana ecosystem. These APIs let you:

  • Retrieve rich token metadata (name, symbol, image, supply, socials, dev wallet, etc.)

  • Access current market data such as price, market cap, liquidity, volume, transaction counts, and holders

  • Analyze token performance with historical snapshots, time-window comparisons, and all-time high tracking

  • Discover and search tokens by symbol, name, address, or trending activity

Together, these endpoints power dashboards, trading terminals, and research tools with structured, real-time token intelligence.

Get Metadata for Token

get

Returns the metadata for a given token address stored in the database.

Path parameters
tokenAddressstringRequired

The token's address (e.g., a Solana address)

Responses
200

Token metadata returned successfully

application/json
get
GET /tokens/{tokenAddress}/metadata HTTP/1.1
Host: 
Accept: */*

{
  "address": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
  "name": "Token Name",
  "symbol": "TOKEN",
  "description": "Example token",
  "image": "https://example.com/token.png",
  "website": "https://example.com",
  "twitter": "@example",
  "telegram": "t.me/example",
  "discord": "discord.gg/example",
  "supply": 1000000,
  "decimals": 9,
  "devWallet": "ABC123...",
  "createdAt": "2025-07-15T00:00:00Z",
  "graduatedAt": "2025-07-16T00:00:00Z",
  "bondingAddress": "0xBonding",
  "marketAddress": "0xMarket"
}

Get Market Data for Token

get

Returns current market-level metrics like price, mcap, txns, holder count, and buy/sell activity. Supports optional time window via 'interval'.

Path parameters
tokenAddressstringRequired

The token's address (e.g., a Solana address)

Query parameters
intervalstring · enumOptional

Optional time window for stats (currently only '24h' is supported).

Default: 24hPossible values:
Responses
200

Market data returned

application/json
get
GET /tokens/{tokenAddress}/market-data HTTP/1.1
Host: 
Accept: */*

{
  "price": 0.1234,
  "mcap": 5000000,
  "liquidity": 120000,
  "holdersCount": 340,
  "top10HoldersPercentage": 72.5,
  "devHoldingsPercentage": 10.1,
  "txns": 180,
  "volume": 250000,
  "buys": 95,
  "sells": 85,
  "interval": "24h"
}

Get Token Holders

post

Returns holder wallet addresses and percentage ownership for a given token address.

Body
tokenAddressstringRequired

The token's address (e.g., a Solana address)

limitintegerOptional

Optional limit on number of holders returned (default: 25, max: 100)

Responses
200

List of holders returned successfully

application/json
post
POST /tokens/holders HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "tokenAddress": "So11111111111111111111111111111111111111112"
}
[
  {
    "address": "text",
    "amount": 1,
    "percentage_owned": 1,
    "lastUpdated": "2025-08-24T10:00:51.444Z"
  }
]

Get Trending Tokens

get

Returns a list of trending tokens ordered by transaction count for a given interval.

Query parameters
intervalstring · enumOptional

Time interval window for counting transactions (default: 5m)

Default: 5mExample: {"value":"5m"}Possible values:
Responses
200

List of trending tokens

application/json
get
GET /tokens/trending HTTP/1.1
Host: 
Accept: */*

[
  {
    "address": "text",
    "symbol": "text",
    "txns": 1,
    "mcap": 1,
    "price": 1,
    "holdersCount": 1
  }
]

Search Tokens

post

Performs a flexible search for tokens by name, symbol, or address, with optional filters, sorting, and symbol-only mode.

Body
searchQuerystringOptional

Query text to search for in name, symbol, or address

limitinteger · min: 1 · max: 25Optional

Number of results to return (1–25)

Default: 10
sortBystring · enumOptional

Field to sort results by

Default: mcapPossible values:
sortOrderstring · enumOptional

Sort order direction

Default: descPossible values:
symbolOnlybooleanOptional

If true, only searches the symbol field

Default: false
Responses
200

List of matching tokens

application/json
post
POST /tokens/search HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "searchQuery": "dog",
  "limit": 10,
  "sortBy": "mcap",
  "sortOrder": "desc",
  "symbolOnly": false
}
[
  {
    "address": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
    "symbol": "CAT",
    "name": "Cat Token"
  },
  {
    "address": "9xbK31Ae4MN...",
    "symbol": "DOGE",
    "name": "DogeFi"
  }
]

Get Latest Graduated Tokens

get

Fetches the most recently graduated tokens, ordered by graduation time (descending).

Query parameters
limitinteger · min: 1 · max: 100Optional

Number of results to return (1–100). Defaults to 25.

Default: 25
Responses
200

List of graduated tokens

application/json
get
GET /tokens/graduated HTTP/1.1
Host: 
Accept: */*

[
  {
    "address": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
    "graduatedAt": "2025-08-21T12:34:56.000Z"
  },
  {
    "address": "9xbK31Ae4MN...",
    "graduatedAt": "2025-08-21T11:59:00.000Z"
  }
]

Get Token ATH

get

Fetches the all-time high (ATH) market cap for a token, starting from its graduation time.

Path parameters
tokenAddressstringRequired

The token's address (e.g., a Solana address)

Responses
200

ATH data returned successfully

application/json
get
GET /tokens/{tokenAddress}/ath HTTP/1.1
Host: 
Accept: */*

{
  "ath": 1234567.89,
  "timestamp": "2025-08-21T14:12:00.000Z"
}

Get Historical Token Price

post

Fetches historical price, market cap, or liquidity snapshots for a token across multiple time windows.

Body
tokenstringRequired

The token's address

Responses
200

Historical data returned successfully

application/json
post
POST /tokens/{tokenAddress}/history HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "token": "text",
  "metrics": [
    "price"
  ]
}
{
  "ANY_ADDITIONAL_PROPERTY": {
    "current": 1,
    "1d": 1,
    "3d": 1,
    "5d": 1,
    "7d": 1,
    "14d": 1,
    "30d": 1
  }
}

Get Metadata by Pool Address

get

Fetches token metadata for a given pool (market) address.

Path parameters
poolAddressstringRequired

The pool (market) address linked to the token

Responses
200

Token metadata for the given pool address

application/json
get
GET /tokens/by-pool/{poolAddress} HTTP/1.1
Host: 
Accept: */*

{
  "address": "text",
  "name": "text",
  "symbol": "text",
  "description": "text",
  "image": "text",
  "website": "text",
  "twitter": "text",
  "telegram": "text",
  "discord": "text",
  "supply": "text",
  "decimals": 1,
  "devWallet": "text",
  "createdAt": "2025-08-24T10:00:51.444Z",
  "graduatedAt": "2025-08-24T10:00:51.444Z",
  "marketAddress": "text",
  "bondingAddress": "text"
}

Get Token Performance

post

Returns percentage performance change for selected metrics over multiple time windows compared to the current value.

Body
tokenstringRequired

Token address to fetch performance data for

Responses
200

Performance data showing % change from current value across time windows.

application/json
post
POST /tokens/{tokenAddress}/performance HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "token": "text",
  "metrics": [
    "price"
  ]
}
{
  "price": {
    "1d": 12.5,
    "3d": -8.2,
    "5d": null,
    "7d": 25.7,
    "14d": 40.1,
    "30d": -3.9
  },
  "mcap": {
    "1d": 15,
    "3d": -10.5,
    "5d": null,
    "7d": 30,
    "14d": 45.3,
    "30d": -5.1
  }
}

Get Token Price

get

Returns the latest price, market cap, and liquidity for a specific token address.

Path parameters
tokenAddressstringRequired

The token's contract address

Responses
200

Token pricing information

application/json
get
GET /tokens/{tokenAddress}/price HTTP/1.1
Host: 
Accept: */*

{
  "price": 0.0025,
  "mcap": 125000,
  "liquidity": 34000
}

Get Token History Range

post

Returns the lowest and highest values of selected metrics (price, market cap, liquidity) within a specified time range for a token.

Path parameters
tokenAddressstringRequired

The token's contract address

Body
time_fromnumberRequired

Unix timestamp (seconds) for range start

time_tonumberRequired

Unix timestamp (seconds) for range end

modestring · enumOptional

Behavior when requested range falls outside token lifespan

Default: clampPossible values:
Responses
200

Range results for the token

application/json
post
POST /tokens/{tokenAddress}/history/range HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "time_from": 1712100000,
  "time_to": 1712700000,
  "metrics": [
    "price",
    "mcap"
  ],
  "mode": "clamp"
}
{
  "token": "So11111111111111111111111111111111111111112",
  "requested_range": {
    "from": 1712100000,
    "to": 1712700000
  },
  "available_range": {
    "from": 1712000000,
    "to": 1712800000
  },
  "effective_range": {
    "from": 1712100000,
    "to": 1712700000
  },
  "clamped": false,
  "price": {
    "lowest": {
      "price": 0.85,
      "time": 1712200000
    },
    "highest": {
      "price": 1.12,
      "time": 1712500000
    }
  },
  "mcap": {
    "lowest": {
      "price": 2000000,
      "time": 1712205000
    },
    "highest": {
      "price": 2500000,
      "time": 1712505000
    }
  }
}
PreviousAuthenticationNextWallet Data