> ## Documentation Index > Fetch the complete documentation index at: https://docs.dexpaprika.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a token's latest data on a network. > Retrieves detailed information about a specific token on the given network, including latest price, metadata, status, and recent summary metrics such as price changes and volumes over multiple timeframes. ## OpenAPI ````yaml /api-reference/openapi.yml get /networks/{network}/tokens/{token_address} openapi: 3.1.0 info: title: DexPaprika API version: 1.0.4 description: > # Introduction Welcome to the DexPaprika API! This product is developed by [CoinPaprika](https://coinpaprika.com). Our API enables developers to query token, pool, and DEX data across multiple blockchain networks. Feel free to explore our endpoints below. **Important:** This API is currently in beta and **should not be used in critical solutions or features**, as the service is under active development. We reserve the right to introduce changes or break backward compatibility. --- # Rate Limits & Monthly Quota Two different limits apply, signalled by distinct status codes: - **429 Too Many Requests**: you are sending requests too fast (per-minute limit). Slow down and retry after the number of seconds given in the `Retry-After` header. - **402 Payment Required**: your monthly credit allowance is exhausted. Retrying will not help; buy a credit pack, enable overage, or upgrade your plan. Both codes carry a structured JSON body (`error`, `tier`, `message`, `credits`, and per-scenario fields; see the 402/429 response schemas below). A 402 includes `resets_at`, the UTC timestamp when your allowance rolls over, and deliberately carries no `Retry-After` header. Responses include an `X-Api-Plan` header naming the plan the request was evaluated against. Call `GET /usage` to check your plan and, when authenticated with an API key on `api-pro.dexpaprika.com`, your current-period credit usage and remaining allowance. --- # Getting Started ## Testing the API - Code Snippets The snippets below show how to quickly make a **GET** request. No API key is needed to start, so you can simply call the endpoints directly. A free registered key raises the monthly credit allowance from 200,000 to 500,000. > **Note**: If you see CORS issues in a browser, you may need to call these endpoints from a backend server to avoid local browser restrictions. ### 1. cURL ```bash curl -X GET "https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5" | jq ``` ### 2. Node.js (JavaScript) ```js const https = require('https'); const options = { hostname: 'api.dexpaprika.com', path: '/networks/ethereum/pools/search?limit=5', method: 'GET', }; const req = https.request(options, res => { let data = ''; res.on('data', chunk => { data += chunk; }); res.on('end', () => { console.log(JSON.parse(data)); }); }); req.on('error', error => { console.error(error); }); req.end(); ``` ### 3. Python ```python import requests url = "https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5" response = requests.get(url) if response.status_code == 200: print(response.json()) else: print(f"Error: {response.status_code} -> {response.text}") ``` ### 4. PHP ```php "https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5", CURLOPT_RETURNTRANSFER => true )); $response = curl_exec($curl); if(curl_errno($curl)) { echo "Error: " . curl_error($curl); } else { echo $response; } curl_close($curl); ?> ``` ### 5. Java ```java import java.io.*; import java.net.HttpURLConnection; import java.net.URL; public class DexPaprikaExample { public static void main(String[] args) { try { URL url = new URL("https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5"); HttpURLConnection con = (HttpURLConnection) url.openConnection(); con.setRequestMethod("GET"); int responseCode = con.getResponseCode(); try (BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()))) { String inputLine; StringBuilder content = new StringBuilder(); while ((inputLine = in.readLine()) != null) { content.append(inputLine); } if (responseCode == 200) { System.out.println(content.toString()); } else { System.out.println("Error: " + responseCode); } } } catch (Exception e) { e.printStackTrace(); } } } ``` ### 6. Go ```go package main import ( "fmt" "io/ioutil" "log" "net/http" ) func main() { client := &http.Client{} req, err := http.NewRequest("GET", "https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5", nil) if err != nil { log.Fatal(err) } resp, err := client.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { log.Fatal(err) } if resp.StatusCode == http.StatusOK { fmt.Println(string(body)) } else { fmt.Printf("Error: %d -> %s\n", resp.StatusCode, body) } } ``` ### 7. C# ```csharp using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main() { using var client = new HttpClient(); var url = "https://api.dexpaprika.com/networks/ethereum/pools/search?limit=5"; var response = await client.GetAsync(url); if (response.IsSuccessStatusCode) { var content = await response.Content.ReadAsStringAsync(); Console.WriteLine(content); } else { Console.WriteLine($"Error: {response.StatusCode}"); } } } ``` ## Feedback & Next Steps 1. **Test** any of the snippets above. 2. **Explore** our other endpoints in this documentation. 3. **Share** your feedback with us at [support@coinpaprika.com](mailto:support@coinpaprika.com). 4. If you want implement our API into your project or simply discuss possible collaboration, please reach out to msroka@coinpaprika.com. --- contact: name: CoinPaprika Support email: support@coinpaprika.com url: https://coinpaprika.com license: name: Proprietary url: https://dexpaprika.com/terms servers: - url: https://api.dexpaprika.com description: Production server security: [] tags: - name: Networks description: Endpoints for retrieving information about supported blockchain networks - name: DEXes description: Endpoints for retrieving information about decentralized exchanges - name: Pools description: Endpoints for retrieving information about liquidity pools - name: Tokens description: Endpoints for retrieving information about tokens - name: Search description: Endpoints for searching across tokens, pools, and DEXes - name: Utils description: Utility endpoints for system metadata paths: /networks/{network}/tokens/{token_address}: get: tags: - Tokens summary: Get a token's latest data on a network. description: > Retrieves detailed information about a specific token on the given network, including latest price, metadata, status, and recent summary metrics such as price changes and volumes over multiple timeframes. operationId: getTokenDetails parameters: - $ref: '#/components/parameters/networkParam' - $ref: '#/components/parameters/tokenAddressParam' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/Token' example: id: JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN name: Jupiter symbol: JUP chain: solana decimals: 6 total_supply: 9999979509174084 description: '' website: '' explorer: '' added_at: '2024-09-11T04:37:20Z' summary: price_usd: 0.6692687725734983 fdv: 6692674011.865073 liquidity_usd: 25796064.003077608 24h: volume: 122851769.74866481 volume_usd: 84119865.87252772 buy_usd: 42059932.93626386 sell_usd: 42059932.93626386 sells: 147309 buys: 77615 txns: 224924 6h: volume: 30490167.650738973 volume_usd: 20100302.93373614 buy_usd: 10050151.46686807 sell_usd: 10050151.46686807 sells: 38908 buys: 21561 txns: 60469 1h: volume: 2339429.714102 volume_usd: 1569385.0617313772 buy_usd: 784692.5308656886 sell_usd: 784692.5308656886 sells: 4476 buys: 2202 txns: 6678 30m: volume: 1053011.5253609999 volume_usd: 705252.1467858246 buy_usd: 352626.0733929123 sell_usd: 352626.0733929123 sells: 1893 buys: 944 txns: 2837 15m: volume: 420812.23249900003 volume_usd: 281063.0592944985 buy_usd: 140531.52964724926 sell_usd: 140531.52964724926 sells: 864 buys: 442 txns: 1306 5m: volume: 75084.709753 volume_usd: 50179.69475522313 buy_usd: 25089.847377611564 sell_usd: 25089.847377611564 sells: 238 buys: 88 txns: 326 last_updated: '2025-02-25T13:44:45.699686371Z' '400': description: The specified network or token address is invalid. content: application/json: schema: type: object properties: error: type: string example: Invalid token address. '402': $ref: '#/components/responses/QuotaExceeded' '404': description: Network not found or token_address not found. content: application/json: schema: type: object properties: error: type: string example: Token not found on this network. '429': $ref: '#/components/responses/RateLimited' components: parameters: networkParam: name: network in: path required: true schema: type: string description: >- Network slug or ID (e.g., 'solana'). You can find the list of supported networks with their IDs here: [/networks](/api-reference/networks). example: solana tokenAddressParam: name: token_address in: path required: true schema: type: string description: >- Token contract address. Such as `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN` for Jupiter on Solana. example: JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN schemas: Token: type: object description: Essential information for a token, including metadata and status. properties: id: type: string description: Internal or canonical ID for the token (e.g., "usdc-usd-coin"). name: type: string description: Human-readable name of the token (e.g., "USD Coin"). symbol: type: string description: Ticker symbol of the token (e.g., "USDC"). chain: type: string description: >- Blockchain network where the token exists (e.g., "ethereum", "solana"). decimals: type: number description: Decimal precision of the token (e.g., 6 for USDC). total_supply: type: number description: Total supply of the token. description: type: string description: >- A detailed overview of the token's purpose, use cases, or background. website: type: string description: Official website URL for the token/project. telegram: type: string description: Official Telegram URL for the token/project. twitter: type: string description: Official Twitter URL for the token/project. explorer: type: string description: Link to a block explorer or analytics page for this token. has_image: type: boolean description: Indicates whether the token has an associated image/logo. added_at: type: string format: date-time description: When the token was added to the system. fdv: type: number description: Fully diluted valuation of the token. last_updated: type: string format: date-time description: When the token data was last updated. summary: $ref: '#/components/schemas/TokenSummary' example: id: usdc-usd-coin name: USD Coin symbol: USDC type: token status: Working product. decimals: 6 description: >- True financial interoperability requires a price stable means of value exchange... website: https://www.centre.io/usdc explorer: https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 TokenSummary: type: object description: > A comprehensive summary of token-related metrics, including price, liquidity, and transaction volumes across various time intervals. properties: price_usd: type: number description: Current price of the token in USD. fdv: type: number description: Fully diluted valuation of token. liquidity_usd: type: number description: Total liquidity (in USD) across all pools for this token. pools: type: number description: Total number of pools that include the given token. 24h: $ref: '#/components/schemas/TimeIntervalMetrics' 6h: $ref: '#/components/schemas/TimeIntervalMetrics' 1h: $ref: '#/components/schemas/TimeIntervalMetrics' 30m: $ref: '#/components/schemas/TimeIntervalMetrics' 15m: $ref: '#/components/schemas/TimeIntervalMetrics' 5m: $ref: '#/components/schemas/TimeIntervalMetrics' 1m: $ref: '#/components/schemas/TimeIntervalMetrics' example: price_usd: 125.67 fdv: 12567 liquidity_usd: 5000000 pools: 5 24h: volume: 100000 volume_usd: 102000 buy_usd: 50000 sell_usd: 52000 sells: 150 buys: 180 txns: 330 last_price_usd_change: 50 6h: volume: 25000 volume_usd: 25500 sells: 45 buys: 50 buy_usd: 12500 sell_usd: 13000 txns: 95 last_price_usd_change: 10 1h: volume: 5000 volume_usd: 5100 buy_usd: 2500 sell_usd: 2600 sells: 10 buys: 15 txns: 25 last_price_usd_change: 2 30m: volume: 2500 volume_usd: 2550 buy_usd: 1250 sell_usd: 1300 sells: 5 buys: 8 txns: 13 last_price_usd_change: 1 15m: volume: 1250 volume_usd: 1275 buy_usd: 675 sell_usd: 700 sells: 2 buys: 4 txns: 6 last_price_usd_change: 0.5 5m: volume: 500 volume_usd: 510 buy_usd: 250 sell_usd: 260 sells: 1 buys: 1 txns: 2 last_price_usd_change: -0.5 1m: volume: 100 volume_usd: 102 buy_usd: 50 sell_usd: 52 sells: 1 buys: 0 txns: 1 last_price_usd_change: 0 QuotaErrorBody: type: object description: > Structured body carried by every 402 and 429 emitted by the billing gate. The shape is constant across scenarios; only fields describing an available action appear. `message` is always a top-level string, so clients parsing the legacy `{"message": ...}` shape keep working. required: - error - tier - message properties: error: type: string enum: - payment_required - rate_limited description: Machine-readable discriminator matching the status code. tier: type: string enum: - anonymous - free_registered - pro description: The billing tier the request was evaluated against. message: type: string description: Human-readable message naming the next action. credits: type: object description: > Credit counters for the current period. One credit is one request. `plan` and `packs` are split out for Pro keys only. `limit` is plan + packs; usage served through overage can exceed it. properties: plan: type: integer format: int64 packs: type: integer format: int64 limit: type: integer format: int64 used: type: integer format: int64 remaining: type: integer format: int64 overage: type: object description: > Overage state, present on Pro 402 bodies. Money amounts are decimal strings, never floats. properties: enabled: type: boolean cap: type: string example: '200.00' used: type: string example: '200.00' block: type: string example: 20.00 per 1M credits resets_at: type: string format: date-time description: When the monthly allowance rolls over (UTC). 402 only. retry_after: type: integer description: Seconds to wait before retrying. 429 only. offer: type: object description: Early-adopter offer, present on the free-tier 402 only. properties: description: type: string expires_at: type: string format: date-time links: type: object additionalProperties: type: string description: > Next-step URLs. Keys vary by scenario: register, upgrade, packs, portal, usage, docs. Absent until the customer-facing pages go live. TimeIntervalMetrics: type: object description: > Transaction and volume metrics for a specific time interval (e.g., 24h, 1h, 15m). properties: volume: type: number description: >- Total trading volume in the token's native currency for the interval. volume_usd: type: number description: Total trading volume in USD for the interval. buy_usd: type: number description: Total USD value of buy transactions during the interval. sell_usd: type: number description: Total USD value of sell transactions during the interval. sells: type: integer description: Number of sell transactions during the interval. buys: type: integer description: Number of buy transactions during the interval. txns: type: integer description: Total number of transactions during the interval. last_price_usd_change: type: number description: >- The percentage change between the current price and the price from the given interval. responses: QuotaExceeded: description: > Monthly credit allowance exhausted. Retrying will not help, because the body names the available next step per tier: register (anonymous), upgrade (free key), or buy a credit pack / enable overage / raise your spend cap (Pro). `resets_at` is when the allowance rolls over (calendar month or billing period, UTC). Deliberately carries no `Retry-After` header. content: application/json: schema: $ref: '#/components/schemas/QuotaErrorBody' examples: anonymous: summary: Anonymous client over the monthly limit value: error: payment_required tier: anonymous message: >- Monthly limit reached for unauthenticated use. Register for a free API key to get 500K credits/month. credits: limit: 200000 used: 200000 remaining: 0 resets_at: '2026-09-01T00:00:00Z' pro_plan_exhausted: summary: Pro key with plan credits drained, overage off value: error: payment_required tier: pro message: >- Monthly credit limit reached. Buy a credit pack or enable overage in the portal. credits: plan: 5000000 packs: 0 limit: 5000000 used: 5000000 remaining: 0 overage: enabled: false resets_at: '2026-09-01T00:00:00Z' RateLimited: description: > Per-minute rate limit exceeded. Slow down and retry after the number of seconds given in the `Retry-After` header. Credits are unaffected; `credits` appears in the body only when the counters were already at hand for the request. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/QuotaErrorBody' example: error: rate_limited tier: pro message: Request rate exceeded. Retry in 12 seconds. credits: plan: 5000000 packs: 0 limit: 5000000 used: 1240880 remaining: 3759120 retry_after: 12 ````