# 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

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/metadata":{"get":{"summary":"Get Metadata for Token","description":"Returns the metadata for a given token address stored in the database. Social fields are omitted.","parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's address (e.g., a Solana address)"}],"responses":{"200":{"description":"Token metadata returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokenName":{"type":"string","nullable":true},"tokenSymbol":{"type":"string","nullable":true},"tokenDescription":{"type":"string","nullable":true},"tokenImage":{"type":"string","nullable":true},"tokenSupply":{"type":"number"},"tokenDecimals":{"type":"integer","nullable":true},"devWallet":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"basePool":{"type":"string","nullable":true},"quotePool":{"type":"string","nullable":true},"pairAddresses":{"type":"array","items":{"type":"string"}}},"required":["tokenSymbol"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing token address path parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"404":{"description":"Token not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}}},"operationId":"get-token-metadata","tags":["Token Data"]}}}}
```

## Get Real-Time Market Data for a Token

> 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.

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/market-data":{"get":{"summary":"Get Real-Time Market Data for a Token","description":"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.","parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's mint address (e.g., a Solana SPL token address)"}],"responses":{"200":{"description":"Real-time market data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"price":{"type":"number"},"marketCap":{"type":"number"},"fdv":{"type":"number"},"liquidity":{"type":"number"},"totalSupply":{"type":"number"},"holdersCount":{"type":"integer"}},"required":["price","marketCap","fdv","liquidity","totalSupply","holdersCount"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid token address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"404":{"description":"Token or its trading pairs not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}}},"operationId":"get-token-marketdata","tags":["Token Data"]}}}}
```

## Get Token Holders

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/holders":{"get":{"operationId":"get-token-holders","summary":"Get Token Holders","description":"Returns ranked holder wallets, amounts, and percentage ownership for a given token address.","tags":["Token Data"],"parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's mint address (e.g., Solana token address)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"maximum":100},"description":"Optional limit on number of holders returned (default: 25, max: 100)"}],"responses":{"200":{"description":"List of holders returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"holders":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","description":"Rank of the holder by token amount (1 = top holder)"},"walletAddress":{"type":"string","description":"Public key of the holder wallet"},"percentageOwned":{"type":"number","description":"Percentage of total token supply owned by the wallet"},"tokenSupply":{"type":"number","description":"Token amount held by the wallet (UI units)"}},"required":["rank","walletAddress","percentageOwned","tokenSupply"]}}},"required":["holders"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"},"limit":{"type":"integer"},"count":{"type":"integer"},"totalSupply":{"type":"number"}},"required":["tokenAddress","limit","count","totalSupply"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid token address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]},"limit":{"type":"integer"}},"required":["tokenAddress","limit"]}},"required":["error","meta"]}}}},"404":{"description":"Token or holders not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"},"limit":{"type":"integer"},"totalSupply":{"type":"number"}},"required":["tokenAddress","limit","totalSupply"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]},"limit":{"type":"integer"}},"required":["tokenAddress","limit"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Trending Tokens

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/trending":{"get":{"summary":"Get Trending Tokens","description":"Returns a list of trending tokens ordered by transaction count for a given interval.","operationId":"get-trending-tokens","tags":["Token Data"],"parameters":[{"name":"interval","in":"query","required":false,"description":"Time interval window for counting transactions (default: 5m)","schema":{"type":"string","enum":["1m","5m","30m","1h"],"default":"5m"}}],"responses":{"200":{"description":"List of trending tokens","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"txns":{"type":"integer"},"mcap":{"type":"number"},"price":{"type":"number"},"holdersCount":{"type":"integer"}}}}}}},"400":{"description":"Invalid interval specified","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Search Tokens

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/search":{"get":{"summary":"Search Tokens","description":"Performs a flexible search for tokens by name, symbol, or address, with optional filters, sorting, and symbol-only mode.","operationId":"search-tokens","tags":["Token Data"],"parameters":[{"name":"searchQuery","in":"query","required":false,"schema":{"type":"string","description":"Query text to search in name, symbol, or address"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10},"description":"Number of results to return (1–25)"},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["created","name","symbol","mcap"],"default":"created"},"description":"Field to sort results by"},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"Sort order direction"}],"responses":{"200":{"description":"List of matching tokens","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"type":"string"},"tokenSymbol":{"type":"string"},"tokenName":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"marketCap":{"type":["number","null"]}},"required":["tokenAddress","tokenSymbol","tokenName"]}}},"required":["tokens"]},"meta":{"type":"object","properties":{"count":{"type":"integer"},"searchQuery":{"type":"string"},"limit":{"type":"integer"},"sortBy":{"type":"string"},"sortOrder":{"type":"string"}},"required":["count","searchQuery","limit","sortBy","sortOrder"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid input (e.g., sortBy not allowed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"searchQuery":{"type":"string"},"limit":{"type":"integer"},"sortBy":{"type":"string"},"sortOrder":{"type":"string"}},"required":["searchQuery","limit","sortBy","sortOrder"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"searchQuery":{"type":"string"},"limit":{"type":"integer"},"sortBy":{"type":"string"},"sortOrder":{"type":"string"}},"required":["searchQuery","limit","sortBy","sortOrder"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Latest Graduated Tokens

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/graduated":{"get":{"summary":"Get Latest Graduated Tokens","description":"Fetches the most recently graduated tokens, ordered by graduation time (descending).","operationId":"get-latest-graduated-tokens","tags":["Token Data"],"parameters":[{"name":"limit","in":"query","description":"Number of results to return (1–100). Defaults to 25.","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"List of graduated tokens","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"type":"string"},"tokenName":{"type":"string","nullable":true},"tokenSymbol":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"graduatedAt":{"type":"string","format":"date-time"}},"required":["tokenAddress","graduatedAt"]}}},"required":["tokens"]},"meta":{"type":"object","properties":{"count":{"type":"integer"},"limit":{"type":"integer"}},"required":["count","limit"]}},"required":["data","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"limit":{"type":"integer"}},"required":["limit"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Token ATH

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/ath":{"get":{"summary":"Get Token ATH","description":"Returns the all-time-high (ATH) market cap and the timestamp when it occurred, based on all historical trades for the token.","operationId":"get-token-ath","tags":["Token Data"],"parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's mint address (Solana SPL token)."}],"responses":{"200":{"description":"ATH data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"ath":{"type":"number","description":"The highest market cap ever recorded for the token."},"timestamp":{"type":["string","null"],"description":"ISO timestamp of when the ATH occurred, or null if no valid ATH exists."}},"required":["ath","timestamp"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid token address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"404":{"description":"No trades found for token, so ATH cannot be calculated","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Historical Token Price

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/history":{"post":{"summary":"Get Historical Token Price","description":"Fetches historical price, market cap, or liquidity snapshots for a token across multiple time windows.","operationId":"get-token-history","tags":["Token Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"The token's address"},"metrics":{"type":"array","items":{"type":"string","enum":["price","mcap","liquidity"]},"description":"List of metrics to fetch (default: [\"price\"])"}},"required":["token"]}}}},"responses":{"200":{"description":"Historical data returned successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"current":{"type":"number","nullable":true},"1d":{"type":"number","nullable":true},"3d":{"type":"number","nullable":true},"5d":{"type":"number","nullable":true},"7d":{"type":"number","nullable":true},"14d":{"type":"number","nullable":true},"30d":{"type":"number","nullable":true}}}}}}},"400":{"description":"Missing token or invalid metrics","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Get Token Performance

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/performance":{"post":{"summary":"Get Token Performance","description":"Returns percentage performance change for selected metrics over multiple time windows compared to the current value.","operationId":"get-token-performance","tags":["Token Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"Token address to fetch performance data for"},"metrics":{"type":"array","description":"List of metrics to evaluate. Supported values: `price`, `mcap`, `liquidity`.","items":{"type":"string","enum":["price","mcap","liquidity"]},"default":["price"]}},"required":["token"]}}}},"responses":{"200":{"description":"Performance data showing % change from current value across time windows.","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"1d":{"type":["number","null"],"description":"Change vs 1 day ago (%)"},"3d":{"type":["number","null"],"description":"Change vs 3 days ago (%)"},"5d":{"type":["number","null"],"description":"Change vs 5 days ago (%)"},"7d":{"type":["number","null"],"description":"Change vs 7 days ago (%)"},"14d":{"type":["number","null"],"description":"Change vs 14 days ago (%)"},"30d":{"type":["number","null"],"description":"Change vs 30 days ago (%)"}}}}}}},"400":{"description":"Invalid or missing request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Get Token Price

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/price":{"get":{"summary":"Get Token Price","description":"Returns the latest price, market cap, and liquidity for a specific token address.","operationId":"get-token-price","tags":["Token Data"],"parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's contract address"}],"responses":{"200":{"description":"Token pricing information","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"price":{"type":"number","description":"Latest token price in USD"},"marketCap":{"type":"number","description":"Token market capitalization"},"liquidity":{"type":"number","description":"Liquidity available for the token"}},"required":["price","marketCap","liquidity"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid token address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"404":{"description":"Token or trade data not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["error","meta"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":["string","null"]}},"required":["tokenAddress"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Token History Range

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

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/history/range":{"post":{"summary":"Get Token History Range","description":"Returns the lowest and highest values of selected metrics (price, market cap, liquidity) within a specified time range for a token.","operationId":"get-token-history-range","tags":["Token Data"],"parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's contract address"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"time_from":{"type":"number","description":"Unix timestamp (seconds) for range start"},"time_to":{"type":"number","description":"Unix timestamp (seconds) for range end"},"metrics":{"type":"array","items":{"type":"string","enum":["price","mcap","liquidity"]},"default":["price"],"description":"Which metrics to return (price, mcap, liquidity)"},"mode":{"type":"string","enum":["clamp","error"],"default":"clamp","description":"Behavior when requested range falls outside token lifespan"}},"required":["time_from","time_to"]}}}},"responses":{"200":{"description":"Range results for the token","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"requested_range":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}}},"available_range":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}}},"effective_range":{"type":"object","nullable":true,"properties":{"from":{"type":"number"},"to":{"type":"number"}}},"clamped":{"type":"boolean"},"warning":{"type":"string"},"price":{"type":"object","properties":{"lowest":{"type":"object","nullable":true,"properties":{"price":{"type":"number"},"time":{"type":"number"}}},"highest":{"type":"object","nullable":true,"properties":{"price":{"type":"number"},"time":{"type":"number"}}}}},"mcap":{"type":"object"},"liquidity":{"type":"object"}}}}}},"400":{"description":"Invalid parameters or body"},"404":{"description":"No data available for token"},"422":{"description":"Requested range falls completely outside token lifespan (mode=error)"},"500":{"description":"Internal server error"}}}}}}
```

## Get Token Audit

> 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.

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/{tokenAddress}/audit":{"get":{"summary":"Get Token Audit","description":"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.\n\n**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.","operationId":"get-token-audit","tags":["Token Data"],"parameters":[{"name":"tokenAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The token's address (e.g., a Solana mint address)"}],"responses":{"200":{"description":"Token audit data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokenSupply":{"type":"number","description":"Total token supply"},"developer":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"},"walletAddress":{"type":["string","null"],"description":"Developer wallet from token.dev_wallet"}}},"top10Holders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"insiders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"bundlers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"snipers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"lpBurn":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}}},"required":["tokenSupply"]},"meta":{"type":"object","properties":{"tokenAddress":{"type":"string"}},"required":["tokenAddress"]}},"required":["data","meta"]}}}}}}}}}
```

## Get Token Audit (Multiple)

> 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.

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Token Data","description":"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."}],"paths":{"/tokens/audit":{"get":{"tags":["Token Data"],"summary":"Get Token Audit (Multiple)","description":"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.\n\n**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.\n\n**Cost:** 10 credits per request.","operationId":"get-token-audit-multiple","parameters":[{"name":"addresses","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated list of up to 10 token mint addresses"}],"responses":{"200":{"description":"Batch token audit data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}},"tokens":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"type":"string","description":"The token mint address"},"tokenSupply":{"type":"number","description":"Total token supply"},"developer":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"},"walletAddress":{"type":["string","null"],"description":"Developer wallet address from token.dev_wallet"}}},"top10Holders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"insiders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"bundlers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"snipers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"lpBurn":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}}},"required":["tokenAddress"]}}},"required":["addresses","tokens"]},"meta":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid query parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}},"invalid":{"type":"array","items":{"type":"string"},"nullable":true}},"required":["addresses"]}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}}},"required":["addresses"]}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.neglect.trade/products/data-services/token-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.