> ## 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. # Search for tokens, pools, and DEXes > Allows users to search across multiple entities (tokens, pools, and DEXes) in a single query. Useful for quickly finding resources by name, symbol, or ID. ## OpenAPI ````yaml /api-reference/openapi.yml get /search 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. Since this is a **public beta** (no API key needed), you can simply call the endpoints directly. > **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" | jq ``` ### 2. Node.js (JavaScript) ```js const https = require('https'); const options = { hostname: 'api.dexpaprika.com', path: '/networks/ethereum/pools', 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" 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", 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"); 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", 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"; 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: /search: get: tags: - Search summary: Search for tokens, pools, and DEXes description: > Allows users to search across multiple entities (tokens, pools, and DEXes) in a single query. Useful for quickly finding resources by name, symbol, or ID. operationId: search parameters: - in: query name: query required: true schema: type: string description: > The search term to match against tokens, pools, or DEX identifiers. For example: "`uniswap`", "`usd coin`", or "`6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN`" (for Solana). responses: '200': description: successful operation content: application/json: schema: type: object properties: tokens: type: array description: An array of matching tokens. items: type: object properties: id: type: string name: type: string symbol: type: string chain: type: string type: type: string status: type: string decimals: type: number total_supply: type: number description: type: string website: type: string explorer: type: string fdv: type: number description: Fully diluted valuation of the token. price_usd: type: number liquidity_usd: type: number volume_usd: type: number price_usd_change: type: number pools: type: array description: An array of matching pools. items: $ref: '#/components/schemas/PoolWithPrices' dexes: type: array description: An array of matching DEXes. items: type: object properties: id: type: string dex_id: type: string dex_name: type: string chain: type: string volume_usd_24h: type: number txns_24h: type: number pools_count: type: number protocol: type: string created_at: type: string format: date-time example: tokens: - id: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN name: OFFICIAL TRUMP symbol: TRUMP chain: solana decimals: 6 total_supply: 1000000000000000 fdv: 1000000000000000000 description: '' website: '' explorer: '' pools: - id: A8nPhpCJqtqHdqUk35Uj9Hy2YsGXFkCZGuNwvkD3k7VC dex_id: LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo dex_name: Meteora chain: solana created_at_block_number: 314590039 created_at: '2025-01-17T14:19:03.000Z' volume_usd: 104433720.13085766 transactions: 17585 price_usd: 26.60780176027208 last_price_change_usd_5m: 0 last_price_change_usd_1h: -1.3047021633422 last_price_change_usd_24h: -8.886488130608807 tokens: - id: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN name: OFFICIAL TRUMP symbol: TRUMP chain: solana decimals: 6 total_supply: 1000000000000000 description: '' website: '' explorer: '' added_at: '2025-01-17T23:26:21.000Z' - id: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v name: USD Coin symbol: USDC chain: solana decimals: 6 total_supply: 0 description: '' website: '' explorer: '' added_at: '2024-10-04T08:30:05.000Z' dexes: [] '400': description: Missing or invalid query parameter. content: application/json: schema: type: object properties: error: type: string example: Missing query parameter. '402': $ref: '#/components/responses/QuotaExceeded' '429': $ref: '#/components/responses/RateLimited' components: schemas: PoolWithPrices: type: object description: >- Information about a specific liquidity pool, including price and volume data. properties: id: type: string description: Unique identifier or address of the pool. dex_id: type: string description: Identifier of the DEX where this pool resides. dex_name: type: string description: Human-readable DEX name (e.g., "Uniswap V3"). chain: type: string description: >- The blockchain network this pool resides on (e.g., "ethereum", "solana"). created_at_block_number: type: number description: Block number at which this pool was created. created_at: type: string format: date-time description: >- Timestamp (ISO-8601) indicating when the pool was created or recorded. volume_usd: type: number description: >- The total USD volume in this pool over a certain period (context-specific). transactions: type: number description: The total number of transactions involving this pool. price_usd: type: number description: >- Current price in USD (often representing a ratio of two tokens in the pool). last_price_change_usd_5m: type: number description: USD price change over the last 5 minutes as a percentage. last_price_change_usd_1h: type: number description: USD price change over the last 1 hour as a percentage. last_price_change_usd_24h: type: number description: USD price change over the last 24 hours as a percentage. fee: type: - number - 'null' description: >- Trading fee (e.g., 0.3 for 0.3%) associated with this pool. Null indicates fee information is not collected. tokens: type: array description: The tokens participating in this liquidity pool. items: items: allOf: - $ref: '#/components/schemas/Token' - type: object properties: fdv: type: number description: Fully diluted valuation of token. 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 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. 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 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 — 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 ````