> ## 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 detailed liquidity, reserves, pricing, and metadata for a specific pool on a blockchain network

# Get a pool on a network.

## Endpoint overview

Get detailed liquidity, reserves, pricing, and metadata for a specific pool.

<Tip>
  See also: [Pool transactions](/api-reference/pools/get-transactions-of-a-pool-on-a-network-paging-can-be-used-up-to-100-pages),
  [Token data](/api-reference/tokens/get-a-tokens-latest-data-on-a-network),
  [Networks](/api-reference/networks/get-a-list-of-available-blockchain-networks)
</Tip>

### FAQs

<AccordionGroup>
  <Accordion title="Which parameters are required?">
    Provide both `network` (e.g., `ethereum`, `solana`) and `pool_address` (on‑chain pool address). Optional: `inversed` to flip the price ratio.
  </Accordion>

  <Accordion title="What does the `inversed` flag do?">
    It returns prices and ratios from the opposite pair perspective (token1/token0). Leave it `false` for the default token0/token1 view.
  </Accordion>

  <Accordion title="How can I find a pool address?">
    Use the Coverage Checker tool or list a token’s pools from the token endpoint, then copy the desired pool’s address.
  </Accordion>

  <Accordion title="What units are returned?">
    Prices are in USD where available; liquidity and volumes include USD fields. Raw token amounts are returned in token units.
  </Accordion>

  <Accordion title="How fresh is the data?">
    Collection is near real‑time; responses reflect the latest indexed blocks/events per network.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {JSON.stringify({
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [
        {"@type": "Question","name": "Which parameters are required?","acceptedAnswer": {"@type": "Answer","text": "Provide both network and pool_address. Optional: inversed to flip price ratio."}},
        {"@type": "Question","name": "What does the inversed flag do?","acceptedAnswer": {"@type": "Answer","text": "Returns prices/ratios from the opposite pair perspective (token1/token0)."}},
        {"@type": "Question","name": "How can I find a pool address?","acceptedAnswer": {"@type": "Answer","text": "Use Coverage Checker or the token pools endpoint and copy the pool address."}},
        {"@type": "Question","name": "What units are returned?","acceptedAnswer": {"@type": "Answer","text": "USD fields for price/liquidity/volume where available; raw token amounts in token units."}},
        {"@type": "Question","name": "How fresh is the data?","acceptedAnswer": {"@type": "Answer","text": "Near real‑time; responses reflect the latest indexed blocks and events."}}
      ]
    })}
</script>


## OpenAPI

````yaml get /networks/{network}/pools/{pool_address}
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

    <?php

    $curl = curl_init();


    curl_setopt_array($curl, array(
      CURLOPT_URL => "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:
  /networks/{network}/pools/{pool_address}:
    get:
      tags:
        - Pools
      summary: Get a pool on a network.
      description: |
        Retrieve detailed information about a specific on-chain pool, 
        including token pairs, current price data, and volume metrics.
      operationId: getPoolDetails
      parameters:
        - $ref: '#/components/parameters/networkParam'
        - $ref: '#/components/parameters/poolAddressParam'
        - $ref: '#/components/parameters/poolInvertedPriceParam'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  created_at_block_number:
                    type: number
                  chain:
                    type: string
                  created_at:
                    type: string
                    format: date-time
                  factory_id:
                    type: string
                  dex_id:
                    type: string
                  dex_name:
                    type: string
                  tokens:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/Token'
                        - type: object
                          properties:
                            fdv:
                              type: number
                              description: Fully diluted valuation of token.
                  last_price:
                    type: number
                  last_price_usd:
                    type: number
                  fee:
                    type: number
                  price_time:
                    type: string
                  24h:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                  6h:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                  1h:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                  30m:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                  15m:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                  5m:
                    type: object
                    properties:
                      last_price_usd_change:
                        type: number
                      volume_usd:
                        type: number
                      buy_usd:
                        type: number
                      sell_usd:
                        type: number
                      sells:
                        type: integer
                      buys:
                        type: integer
                      txns:
                        type: integer
                example:
                  id: 8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj
                  chain: solana
                  factory_id: CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK
                  dex_id: raydium_clmm
                  dex_name: Raydium CLMM
                  created_at_block_number: 232424998
                  fee: 0
                  created_at: '2023-11-26T20:25:08.000Z'
                  tokens:
                    - id: So11111111111111111111111111111111111111112
                      name: Wrapped SOL
                      symbol: SOL
                      chain: solana
                      decimals: 9
                      added_at: '2024-10-04T08:30:05.000Z'
                      fdv: 94441873213
                    - id: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      name: USD Coin
                      symbol: USDC
                      chain: solana
                      decimals: 6
                      added_at: '2024-10-04T08:30:05.000Z'
                      fdv: 7700000000
                  last_price: 233.8201620378884
                  last_price_usd: 234.1327298484414
                  price_time: '2025-01-27T16:12:16.000Z'
                  24h:
                    last_price_usd_change: -7.991645970375927
                    volume_usd: 808169281.4395584
                    sell_usd: 404084640.7197792
                    buy_usd: 404084640.7197792
                    sells: 130647
                    buys: 138125
                    txns: 268772
                  6h:
                    last_price_usd_change: 3.678167601422392
                    volume_usd: 239714337.5522164
                    sell_usd: 119857168.7761082
                    buy_usd: 119857168.7761082
                    sells: 37349
                    buys: 37942
                    txns: 75291
                  1h:
                    last_price_usd_change: 0.21468385213358251
                    volume_usd: 38581519.09849599
                    sell_usd: 19290759.549247995
                    buy_usd: 19290759.549247995
                    sells: 5855
                    buys: 6280
                    txns: 12135
                  30m:
                    last_price_usd_change: -0.6596647484596703
                    volume_usd: 17156573.023071297
                    sell_usd: 8578286.511535648
                    buy_usd: 8578286.511535648
                    sells: 2573
                    buys: 2989
                    txns: 5562
                  15m:
                    last_price_usd_change: 0.10278852417240747
                    volume_usd: 8712008.133446362
                    sell_usd: 4356004.066723181
                    buy_usd: 4356004.066723181
                    sells: 1231
                    buys: 1464
                    txns: 2695
                  5m:
                    last_price_usd_change: 0.01045314121300838
                    volume_usd: 3102185.350890263
                    sell_usd: 1551092.6754451315
                    buy_usd: 1551092.6754451315
                    sells: 479
                    buys: 474
                    txns: 953
        '400':
          description: The specified network or pool address is invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid request parameters.
        '404':
          description: Network or pool not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Pool not found.
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
    poolAddressParam:
      name: pool_address
      in: path
      required: true
      schema:
        type: string
      description: >-
        Unique pool address or identifier. Such as
        `0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b` for WETH / USDT on
        `ethereum`.
      example: '0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b'
    poolInvertedPriceParam:
      name: inversed
      in: query
      required: false
      schema:
        type: boolean
        default: false
      description: Whether to invert the main price ratio in pool calculations.
  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
    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.

````