Token Data

Real-time and historical Solana token data over REST. Covers metadata, single and batch audits (developer, top 10 holders, insiders, bundlers, snipers, lpBurn), live price and market data (price, marketCap, FDV, liquidity, totalSupply, holdersCount), all-time-high market cap, top holder rankings, search, recently graduated tokens, and trending tokens by transaction count over 1m / 5m / 30m / 1h windows. Historical endpoints return price, marketCap, or liquidity snapshots at fixed lookbacks (1d, 3d, 5d, 7d, 14d, 30d), low/high extremes within a custom time range, and percentage performance comparisons. Use them to build token discovery feeds, market-cap dashboards, charting widgets, due-diligence flows, and on-chain analytics.

Get Metadata for Token

get

Returns the metadata for a given token address stored in the database. Social fields are omitted.

Path parameters

tokenAddressstringRequired

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

Responses

200

Token metadata returned successfully

application/json

400

Missing token address path parameter

application/json

404

Token not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/metadata

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/metadata HTTP/1.1
Accept: */*

{
  "data": {
    "tokenName": "Token Name",
    "tokenSymbol": "TOKEN",
    "tokenDescription": "Example token",
    "tokenImage": "https://example.com/token.png",
    "tokenSupply": 1000000,
    "tokenDecimals": 9,
    "devWallet": "ABC123...",
    "createdAt": "2025-07-15T00:00:00Z",
    "basePool": "BasePoolAddress",
    "quotePool": "QuotePoolAddress",
    "pairAddresses": [
      "0xPairA",
      "0xPairB"
    ]
  },
  "meta": {
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}

Get Real-Time Market Data for a Token

get

Returns real-time metrics for a Solana token: price, market capitalization, FDV, liquidity (USD), total supply, and current holder count. Aggregates across the token's pairs, picking the canonical price from the highest-liquidity WSOL/USDC/USDT pair so the value matches major DEX trackers. This endpoint returns a single live snapshot — it does not use time windows and does not include trade statistics.

Path parameters

tokenAddressstringRequired

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

Responses

200

Real-time market data returned successfully

application/json

400

Missing or invalid token address

application/json

404

Token or its trading pairs not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/market-data

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/market-data HTTP/1.1
Accept: */*

{
  "data": {
    "price": 0.1234,
    "marketCap": 5000000,
    "fdv": 20000000,
    "liquidity": 120000,
    "totalSupply": 1000000000,
    "holdersCount": 340
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Token Holders

get

Returns ranked holder wallets, amounts, and percentage ownership for a given token address.

Path parameters

tokenAddressstringRequired

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

Query parameters

limitinteger · max: 100Optional

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

Default: 25

Responses

200

List of holders returned successfully

application/json

400

Missing or invalid token address

application/json

404

Token or holders not found

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/holders

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/holders HTTP/1.1
Accept: */*

{
  "data": {
    "holders": [
      {
        "rank": 1,
        "walletAddress": "Dgj8w1YxzHCnfg7rzZkRzZkd1oEM2HaxX6Rfvi7eKnBX",
        "percentageOwned": 99.9294,
        "tokenSupply": 999293962.873546
      }
    ]
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "limit": 25,
    "count": 1,
    "totalSupply": 1000000000
  }
}

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

addressstringOptional

symbolstringOptional

txnsintegerOptional

mcapnumberOptional

pricenumberOptional

holdersCountintegerOptional

400

Invalid interval specified

application/json

500

Unexpected server error

application/json

get

/tokens/trending

HTTPcURLJavaScriptPython

GET /tokens/trending HTTP/1.1
Accept: */*

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

Search Tokens

get

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

Query parameters

searchQuerystringOptional

Query text to search 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: createdPossible values:

sortOrderstring · enumOptional

Sort order direction

Default: descPossible values:

Responses

200

List of matching tokens

application/json

400

Invalid input (e.g., sortBy not allowed)

application/json

500

Unexpected server error

application/json

get

/tokens/search

HTTPcURLJavaScriptPython

GET /tokens/search HTTP/1.1
Accept: */*

{
  "data": {
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenSymbol": "CAT",
        "tokenName": "Cat Token",
        "createdAt": "2024-01-12T04:12:55Z",
        "marketCap": null
      },
      {
        "tokenAddress": "9xbK31Ae4MNEXAMPLE...",
        "tokenSymbol": "DOGE",
        "tokenName": "DogeFi",
        "createdAt": "2023-12-05T18:22:11Z",
        "marketCap": 12400000
      }
    ]
  },
  "meta": {
    "count": 2,
    "searchQuery": "dog",
    "limit": 10,
    "sortBy": "created",
    "sortOrder": "DESC"
  }
}

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

500

Unexpected server error

application/json

get

/tokens/graduated

HTTPcURLJavaScriptPython

GET /tokens/graduated HTTP/1.1
Accept: */*

{
  "data": {
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenName": "DogWater",
        "tokenSymbol": "DWTR",
        "createdAt": "2025-08-21T11:12:30.000Z",
        "graduatedAt": "2025-08-21T12:34:56.000Z"
      },
      {
        "tokenAddress": "9xbK31Ae4MN...",
        "tokenName": "MemeTron",
        "tokenSymbol": "TRON",
        "createdAt": "2025-08-21T10:58:00.000Z",
        "graduatedAt": "2025-08-21T11:59:00.000Z"
      }
    ]
  },
  "meta": {
    "count": 2,
    "limit": 25
  }
}

Get Token ATH

get

Returns the all-time-high (ATH) market cap and the timestamp when it occurred, based on all historical trades for the token.

Path parameters

tokenAddressstringRequired

The token's mint address (Solana SPL token).

Responses

200

ATH data returned successfully

application/json

400

Missing or invalid token address

application/json

404

No trades found for token, so ATH cannot be calculated

application/json

500

Unexpected server error

application/json

get

/tokens/{tokenAddress}/ath

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/ath HTTP/1.1
Accept: */*

{
  "data": {
    "ath": 1834000.45,
    "timestamp": "2025-08-21T14:12:00.000Z"
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

Get Historical Token Price

post

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

Body

application/json

tokenstringRequired

The token's address

Responses

200

Historical data returned successfully

application/json

400

Missing token or invalid metrics

application/json

500

Unexpected server error

application/json

post

/tokens/{tokenAddress}/history

HTTPcURLJavaScriptPython

POST /tokens/{tokenAddress}/history HTTP/1.1
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 Token Performance

post

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

Body

application/json

tokenstringRequired

Token address to fetch performance data for

Responses

200

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

application/json

400

Invalid or missing request body

application/json

500

Unexpected server error

application/json

post

/tokens/{tokenAddress}/performance

HTTPcURLJavaScriptPython

POST /tokens/{tokenAddress}/performance HTTP/1.1
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

400

Missing or invalid token address

application/json

404

Token or trade data not found

application/json

500

Server error

application/json

get

/tokens/{tokenAddress}/price

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/price HTTP/1.1
Accept: */*

{
  "data": {
    "price": 0.0025,
    "marketCap": 125000,
    "liquidity": 34000
  },
  "meta": {
    "tokenAddress": "So11111111111111111111111111111111111111112"
  }
}

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

application/json

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

tokenstringOptional

clampedbooleanOptional

warningstringOptional

mcapobjectOptional

liquidityobjectOptional

400

Invalid parameters or body

404

No data available for token

422

Requested range falls completely outside token lifespan (mode=error)

500

Internal server error

post

/tokens/{tokenAddress}/history/range

HTTPcURLJavaScriptPython

POST /tokens/{tokenAddress}/history/range HTTP/1.1
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
    }
  }
}

Get Token Audit

get

Returns supply distribution audit data for a Solana token: developer holdings, top 10 holders, insiders, bundlers, snipers, and LP burn percentages plus matching token amounts. Useful for due-diligence dashboards and red-flag scoring.

Note: lpBurn is currently always reported as zero. Burn-address detection is not yet enabled against the current data schema; the field is preserved for response shape compatibility and will be populated in a future release.

Path parameters

tokenAddressstringRequired

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

Responses

200

Token audit data returned successfully

application/json

get

/tokens/{tokenAddress}/audit

HTTPcURLJavaScriptPython

GET /tokens/{tokenAddress}/audit HTTP/1.1
Accept: */*

200

Token audit data returned successfully

{
  "data": {
    "tokenSupply": 1000000,
    "developer": {
      "tokenSupply": 102000,
      "percent": 10.2,
      "walletAddress": "C9fjP4xqM2k8PnRftz1234abcXYZ..."
    },
    "top10Holders": {
      "tokenSupply": 705000,
      "percent": 70.5
    },
    "insiders": {
      "tokenSupply": 19000,
      "percent": 1.9
    },
    "bundlers": {
      "tokenSupply": 28000,
      "percent": 2.8
    },
    "snipers": {
      "tokenSupply": 11000,
      "percent": 1.1
    },
    "lpBurn": {
      "tokenSupply": 40000,
      "percent": 4
    }
  },
  "meta": {
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}

Get Token Audit (Multiple)

get

Returns audit data for up to 10 Solana tokens in a single batch call via a comma-separated addresses query parameter. Each entry includes developer, top 10 holders, insiders, bundlers, snipers, and lpBurn distributions plus matching token amounts.

Note: lpBurn is currently always reported as zero. Burn-address detection is not yet enabled against the current data schema; the field is preserved for response shape compatibility and will be populated in a future release.

Cost: 10 credits per request.

Query parameters

addressesstringRequired

Comma-separated list of up to 10 token mint addresses

Example: address1,address2

Responses

200

Batch token audit data returned successfully

application/json

400

Missing or invalid query parameter

application/json

500

Internal server error

application/json

get

/tokens/audit

HTTPcURLJavaScriptPython

GET /tokens/audit?addresses=address1%2Caddress2 HTTP/1.1
Accept: */*

{
  "data": {
    "addresses": [
      "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
      "7Yt5uF3r9cTdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc"
    ],
    "tokens": [
      {
        "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump",
        "tokenSupply": 1000000,
        "developer": {
          "tokenSupply": 105000,
          "percent": 10.5,
          "walletAddress": "F7Rk2x3PT6ZC3XnKk9bAopYfM1s4W8JZTqgA1Yj2uCVZ"
        },
        "top10Holders": {
          "tokenSupply": 720000,
          "percent": 72
        },
        "bundlers": {
          "tokenSupply": 23000,
          "percent": 2.3
        },
        "insiders": {
          "tokenSupply": 18000,
          "percent": 1.8
        },
        "snipers": {
          "tokenSupply": 9000,
          "percent": 0.9
        },
        "lpBurn": {
          "tokenSupply": 35000,
          "percent": 3.5
        }
      },
      {
        "tokenAddress": "7Yt5uF3r9cTdxP5vsmg8JXbK8svDqY1N9aEz21X4vhsXc",
        "tokenSupply": 2500000,
        "developer": {
          "tokenSupply": 200000,
          "percent": 8,
          "walletAddress": "C4HkR5aN2dF3V8JZTqgA1Yj2uCVZ..."
        },
        "top10Holders": {
          "tokenSupply": 1850000,
          "percent": 74
        },
        "bundlers": {
          "tokenSupply": 30000,
          "percent": 3
        },
        "insiders": {
          "tokenSupply": 22000,
          "percent": 2.2
        },
        "snipers": {
          "tokenSupply": 15000,
          "percent": 1.5
        },
        "lpBurn": {
          "tokenSupply": 41000,
          "percent": 4.1
        }
      }
    ]
  },
  "meta": {
    "count": 2
  }
}