> ## 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 top X pools. (DEPRECATED) > **THIS ENDPOINT HAS BEEN DEPRECATED AND WILL BE REMOVED.** It now returns a 410 Gone status. Please refer to our API documentation for alternatives. --- *Original Description (for historical reference):* Retrieves a paginated list of top pools from all (or specific) networks. Allows sorting and ordering, providing aggregated volume, price data, and token details for each pool. ## OpenAPI ````yaml /api-reference/openapi.yml get /pools openapi: 3.1.0 info: title: DexPaprika API version: 1.0.2 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. --- # 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: /pools: get: tags: - Pools summary: Get top X pools. (DEPRECATED) description: > **THIS ENDPOINT HAS BEEN DEPRECATED AND WILL BE REMOVED.** It now returns a 410 Gone status. Please refer to our API documentation for alternatives. --- *Original Description (for historical reference):* Retrieves a paginated list of top pools from all (or specific) networks. Allows sorting and ordering, providing aggregated volume, price data, and token details for each pool. operationId: getTopPools parameters: - $ref: '#/components/parameters/pageParam' - $ref: '#/components/parameters/limitParam' - $ref: '#/components/parameters/sortParam' - $ref: '#/components/parameters/orderParam' responses: '200': description: successful operation content: application/json: schema: type: object properties: pools: type: array description: An array of pool objects with their associated price data. items: $ref: '#/components/schemas/PoolWithPrices' page_info: type: object description: Details about the current page of results. properties: limit: type: integer description: The maximum number of items returned per page. page: type: integer description: The current page number. total_items: type: integer description: The total number of items matching the query. total_pages: type: integer description: The total number of pages available. example: pools: - id: 8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj dex_id: CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK dex_name: Raydium CLMM chain: solana volume_usd: 829807420.5052161 created_at: '2023-11-26T20:25:08.000Z' created_at_block_number: 232424998 transactions: 273978 price_usd: 228.70162563938777 last_price_change_usd_5m: 0.05658913344914529 last_price_change_usd_1h: -2.2971851257064313 last_price_change_usd_24h: -10.883264918629346 fee: 0 tokens: - id: So11111111111111111111111111111111111111112 name: Wrapped SOL symbol: SOL chain: solana decimals: 9 added_at: '2024-10-04T08:30:05.000Z' - id: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v name: USD Coin symbol: USDC chain: solana decimals: 6 added_at: '2024-10-04T08:30:05.000Z' page_info: limit: 100 page: 1 total_items: 121650 total_pages: 1217 '400': description: The specified network is invalid. content: application/json: schema: type: object properties: error: type: string example: Invalid network. '404': description: Network not found. content: application/json: schema: type: object properties: error: type: string example: Network not found. '410': description: Endpoint Removed. This endpoint has been permanently removed. content: application/json: schema: type: object properties: error: type: string example: Endpoint Removed message: type: string example: >- This endpoint has been permanently removed. Please refer to our API documentation for alternatives. deprecated: true components: parameters: pageParam: name: page in: query schema: type: integer minimum: 0 maximum: 1000 description: Zero-based page index for paginated results. limitParam: name: limit in: query schema: type: integer default: 10 minimum: 1 maximum: 100 description: Number of items to return per page (max 100). sortParam: name: sort in: query schema: type: string enum: - asc - desc description: Sort order for the requested data (ascending or descending). orderParam: name: order_by in: query schema: type: string enum: - volume_usd - price_usd - transactions - last_price_change_usd_24h - created_at description: Field by which to order the returned data. 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 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. ````