💰Pairs

Endpoint

GET /api/v1/pairs

Description

This endpoint returns the top 10 pairs for a given token by volume and the value of the liquidity pool. The asset_id parameter is required and should be a string in the format <TOKEN_CONTRACT_ADDRESS>:<NETWORK_ID>. The TOKEN_CONTRACT_ADDRESS is the address of the token contract on the specified network, and the NETWORK_ID is the ID of the network the token is on. See supported networks for more info.

Query String Parameters

  • asset_id (required): A string in the format <TOKEN_CONTRACT_ADDRESS>:<NETWORK_ID> that identifies the tokens to look up.

Headers

  • x-api-key (required): A valid API key.

Example

curl -X GET 'https://data.lynxcrypto.app/api/v1/pairs?asset_id=0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c%3A56'
-H 'x-api-key: <YOUR_API_KEY>'

Response

[
    {
        "pair_id": "0x47a90a2d92a8367a91efa1906bfc8c1e05bf10c4:56",
        "chain": 56,
        "change": 0.03690846561119262,
        "factory_address": "0xdb1d10011ad0ff90774d0c6bb92e5c5c8b4461f7",
        "factory_name": "uniswap_v3",
        "liquidity_value": 859858.7057705261,
        "pair_address": "0x47a90a2d92a8367a91efa1906bfc8c1e05bf10c4",
        "token0_address": "0x55d398326f99059ff775485246999027b3197955:56",
        "token0_price": 1.0011174445212616,
        "token0_reserves": 643605.8905096864,
        "token0_symbol": "usdt",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 378.7297,
        "token1_reserves": 569.0961690742446,
        "token1_symbol": "wbnb",
        "volume": 4466126.959842104
    },
    {
        "pair_id": "0x0ed7e52944161450477ee417de9cd3a859b14fd0:56",
        "chain": 56,
        "change": -2.7947886127587243,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 56802757.31115264,
        "pair_address": "0x0ed7e52944161450477ee417de9cd3a859b14fd0",
        "token0_address": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82:56",
        "token0_price": 3.1330884245169166,
        "token0_reserves": 9054575.080045596,
        "token0_symbol": "cake",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 379.1332499999999,
        "token1_reserves": 74997.30751376317,
        "token1_symbol": "wbnb",
        "volume": 4356723.484223897
    },
    {
        "pair_id": "0x293de76a3db04f1fe8decf82cc5a1ffd13aa8b35:56",
        "chain": 56,
        "change": 2485.9396817258253,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 390053.3757227397,
        "pair_address": "0x293de76a3db04f1fe8decf82cc5a1ffd13aa8b35",
        "token0_address": "0x13e1d695873d6dc1e2f573eab10bfb951e60eeb6:56",
        "token0_price": 0.00451841499459681,
        "token0_reserves": 43129778.86585921,
        "token0_symbol": "sora",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 382.0824,
        "token1_reserves": 510.81948862757577,
        "token1_symbol": "wbnb",
        "volume": 3794752.2567351833
    },
    {
        "pair_id": "0xc800f3b67b7df689dba4c8e038c808f1d2fb54d3:56",
        "chain": 56,
        "change": 11.202482233438042,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 330528.2779905562,
        "pair_address": "0xc800f3b67b7df689dba4c8e038c808f1d2fb54d3",
        "token0_address": "0x73e691fad606714bca62bda60e9a935c18b28902:56",
        "token0_price": 0.0027145531976490683,
        "token0_reserves": 60944481.623098016,
        "token0_symbol": "portal",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 378.72970000000004,
        "token1_reserves": 435.907826931742,
        "token1_symbol": "wbnb",
        "volume": 3745139.9423544365
    },
    {
        "pair_id": "0x82414fa9e62e845dfd339758ccde26681410498a:56",
        "chain": 56,
        "change": 123.02052700408149,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 153416.48063001665,
        "pair_address": "0x82414fa9e62e845dfd339758ccde26681410498a",
        "token0_address": "0x6a29e475b0cae2e84181cd4968154018e6924989:56",
        "token0_price": 0.0006100239494815383,
        "token0_reserves": 125283687.47785522,
        "token0_symbol": "gmrx",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 378.72970000000004,
        "token1_reserves": 203.28596038062145,
        "token1_symbol": "wbnb",
        "volume": 3001743.38074118
    },
    {
        "pair_id": "0x4141325bac36affe9db165e854982230a14e6d48:56",
        "chain": 56,
        "change": 0.07733189325578718,
        "factory_address": "0xdb1d10011ad0ff90774d0c6bb92e5c5c8b4461f7",
        "factory_name": "uniswap_v3",
        "liquidity_value": 156755.7870997406,
        "pair_address": "0x4141325bac36affe9db165e854982230a14e6d48",
        "token0_address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d:56",
        "token0_price": 1.0009610990851687,
        "token0_reserves": 65346.948842961305,
        "token0_symbol": "usdc",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 378.7297,
        "token1_reserves": 241.19057302352513,
        "token1_symbol": "wbnb",
        "volume": 2883477.801814465
    },
    {
        "pair_id": "0x346575fc7f07e6994d76199e41d13dc1575322e1:56",
        "chain": 56,
        "change": 5.999195022667739,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 33927207.2219377,
        "pair_address": "0x346575fc7f07e6994d76199e41d13dc1575322e1",
        "token0_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token0_price": 378.7297,
        "token0_reserves": 44734.932485282676,
        "token0_symbol": "wbnb",
        "token1_address": "0xf7de7e8a6bd59ed41a4b5fe50278b3b7f31384df:56",
        "token1_price": 0.35781801144705205,
        "token1_reserves": 47467592.79550591,
        "token1_symbol": "rdnt",
        "volume": 2636376.9262686796
    },
    {
        "pair_id": "0x8f893d70f172adbd58d467f521ad625401e69161:56",
        "chain": 56,
        "change": -99.99999998566913,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 0.7478833846149244,
        "pair_address": "0x8f893d70f172adbd58d467f521ad625401e69161",
        "token0_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token0_price": 382.2098999999999,
        "token0_reserves": 0.000977210014603945,
        "token0_symbol": "wbnb",
        "token1_address": "0xbb4eb4183853b6e27b057ab5c591310d5eb3e9fc:56",
        "token1_price": 5.125941325542194e-14,
        "token1_reserves": 7303712993916.329,
        "token1_symbol": "sora404",
        "volume": 2142358.2938423636
    },
    {
        "pair_id": "0x0f338ec12d3f7c3d77a4b9fcc1f95f3fb6ad0ea6:56",
        "chain": 56,
        "change": 2.732091528624462,
        "factory_address": "0xdb1d10011ad0ff90774d0c6bb92e5c5c8b4461f7",
        "factory_name": "uniswap_v3",
        "liquidity_value": 1115327.0991885485,
        "pair_address": "0x0f338ec12d3f7c3d77a4b9fcc1f95f3fb6ad0ea6",
        "token0_address": "0x2170ed0880ac9a755fd29b2688956bd959f933f8:56",
        "token0_price": 3021.586266513289,
        "token0_reserves": 137.1030090362667,
        "token0_symbol": "eth",
        "token1_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token1_price": 378.7297,
        "token1_reserves": 1851.0788300651302,
        "token1_symbol": "wbnb",
        "volume": 1611902.7772420126
    },
    {
        "pair_id": "0x6cf67105e7ff4ba972b0cd953a2ebcb41a12de0e:56",
        "chain": 56,
        "change": -99.99995472282369,
        "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
        "factory_name": "pancakeswap_v2",
        "liquidity_value": 197.93605255995791,
        "pair_address": "0x6cf67105e7ff4ba972b0cd953a2ebcb41a12de0e",
        "token0_address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c:56",
        "token0_price": 379.45534999999995,
        "token0_reserves": 6.006755731499e-6,
        "token0_symbol": "wbnb",
        "token1_address": "0xd3b544b3e7a4b6eff854ecb219ecfaa63a35a8d4:56",
        "token1_price": 2.22959822595752e-11,
        "token1_reserves": 8877553406706.498,
        "token1_symbol": "sup",
        "volume": 1419902.5223513015
    }
]

Response Codes

  • 200: Success. Returns the top pairs for a token.

  • 400: Bad Request. The asset_id query string parameter is not provided.

  • 403: Forbidden. The x-api-key header is not provided or is invalid.

Last updated