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.
Returns the metadata for a given token address stored in the database. Social fields are omitted.
The token's address (e.g., a Solana address)
Token metadata returned successfully
Missing token address path parameter
Token not found
Unexpected server error
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"
}
}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.
The token's mint address (e.g., a Solana SPL token address)
Real-time market data returned successfully
Missing or invalid token address
Token or its trading pairs not found
Unexpected server error
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"
}
}Returns ranked holder wallets, amounts, and percentage ownership for a given token address.
The token's mint address (e.g., Solana token address)
Optional limit on number of holders returned (default: 25, max: 100)
25List of holders returned successfully
Missing or invalid token address
Token or holders not found
Unexpected server error
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
}
}Returns a list of trending tokens ordered by transaction count for a given interval.
Time interval window for counting transactions (default: 5m)
5mExample: {"value":"5m"}Possible values: List of trending tokens
Invalid interval specified
Unexpected server error
GET /tokens/trending HTTP/1.1
Accept: */*
[
{
"address": "text",
"symbol": "text",
"txns": 1,
"mcap": 1,
"price": 1,
"holdersCount": 1
}
]Performs a flexible search for tokens by name, symbol, or address, with optional filters, sorting, and symbol-only mode.
Query text to search in name, symbol, or address
Number of results to return (1–25)
10Field to sort results by
createdPossible values: Sort order direction
descPossible values: List of matching tokens
Invalid input (e.g., sortBy not allowed)
Unexpected server error
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"
}
}Fetches the most recently graduated tokens, ordered by graduation time (descending).
Number of results to return (1–100). Defaults to 25.
25List of graduated tokens
Unexpected server error
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
}
}Returns the all-time-high (ATH) market cap and the timestamp when it occurred, based on all historical trades for the token.
The token's mint address (Solana SPL token).
ATH data returned successfully
Missing or invalid token address
No trades found for token, so ATH cannot be calculated
Unexpected server error
GET /tokens/{tokenAddress}/ath HTTP/1.1
Accept: */*
{
"data": {
"ath": 1834000.45,
"timestamp": "2025-08-21T14:12:00.000Z"
},
"meta": {
"tokenAddress": "So11111111111111111111111111111111111111112"
}
}Fetches historical price, market cap, or liquidity snapshots for a token across multiple time windows.
The token's address
Historical data returned successfully
Missing token or invalid metrics
Unexpected server error
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
}
}Returns percentage performance change for selected metrics over multiple time windows compared to the current value.
Token address to fetch performance data for
Performance data showing % change from current value across time windows.
Invalid or missing request body
Unexpected server error
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
}
}Returns the latest price, market cap, and liquidity for a specific token address.
The token's contract address
Token pricing information
Missing or invalid token address
Token or trade data not found
Server error
GET /tokens/{tokenAddress}/price HTTP/1.1
Accept: */*
{
"data": {
"price": 0.0025,
"marketCap": 125000,
"liquidity": 34000
},
"meta": {
"tokenAddress": "So11111111111111111111111111111111111111112"
}
}Returns the lowest and highest values of selected metrics (price, market cap, liquidity) within a specified time range for a token.
The token's contract address
Unix timestamp (seconds) for range start
Unix timestamp (seconds) for range end
Behavior when requested range falls outside token lifespan
clampPossible values: Range results for the token
Invalid parameters or body
No data available for token
Requested range falls completely outside token lifespan (mode=error)
Internal server error
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
}
}
}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.
The token's address (e.g., a Solana mint address)
Token audit data returned successfully
GET /tokens/{tokenAddress}/audit HTTP/1.1
Accept: */*
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"
}
}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.
Comma-separated list of up to 10 token mint addresses
address1,address2Batch token audit data returned successfully
Missing or invalid query parameter
Internal server error
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
}
}Last updated