pairs

Fetch up to 200 pairs by ID (address:networkId, or poolId:networkId for singleton pools like Uniswap V4), returned in request order.

​

Returns

Pair · [Pair]!

See Pair

Show Properties

address · String!

The contract address of the pair.

exchangeHash · String!

The address for the exchange factory contract.

fee · Int

The exchange fee for swaps.

id · String!

The ID for the pair (address:networkId).

networkId · Int!

The network ID the pair is deployed on.

protocol · String

The protocol of the pair. E.g. UniswapV4, RaydiumV4, PumpV1, etc.

tickSpacing · Int

The amount of required tick separation. Only applicable for pairs on UniswapV3.

token0 · String!

The contract address of token0.

token1 · String!

The contract address of token1.

createdAt · Int

The unix timestamp for the creation of the pair.

token0Data · EnhancedToken

Metadata for the first token in the pair. See EnhancedToken

token1Data · EnhancedToken

Metadata for the second token in the pair. See EnhancedToken

pooled · PooledTokenValues

The pooled amounts of each token in the pair. See PooledTokenValues

virtualPooled · PooledTokenValues

The virtual pooled amounts of each token in the pair. See PooledTokenValues

currencyUnits · CurrencyUnits

The measurement units of this pool’s raw side amounts and reserves; null when the pool measures in its tokens’ metadata. See CurrencyUnits

protocolData · ProtocolData

Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example) See ProtocolData

protocolCustomData · PairProtocolCustomData · deprecated

The per-protocol data for the pair, if applicable See PairProtocolCustomData

This field is deprecated. Use protocolData instead

​

Arguments

ids · [String!]! · required

A list of pair IDs (address:networkId).

​

Example

Test this query in the Explorer →

{
  pairs(
    ids: [
      "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640:1"
      "0x21c67e77068de97969ba93d4aab21826d33ca12bb9f565d8496e8fda8a82ca27:1"
      "PAIR_ADDRESS:1399811149"
    ]
  ) {
    id
    address
    networkId
    protocol
    fee
    tickSpacing
    createdAt
    token0
    token1
    token0Data {
      symbol
    }
    token1Data {
      symbol
    }
    pooled {
      token0
      token1
    }
  }
}

​

Usage Guidelines

• Pass pair IDs as address:networkId. For Uniswap V4 and other singleton pools, use the pool ID in place of the address
• Up to 200 IDs per request. Results come back in the same order as ids, one entry per ID, so you can match them by index. A repeated ID returns the pair again
• An ID that isn’t a known pair returns null in its slot instead of failing the request. This includes an ID without a :networkId suffix, an unknown network, and a token address
• EVM addresses match case-insensitively, so checksummed addresses work
• IDs can mix networks in one request
• pairs returns pair details: tokens, protocol, fee, tick spacing, creation time and pooled reserves. For prices, volume and liquidity, use getDetailedPairsStats, pairMetadata or filterPairs

​

Troubleshooting Tips

Why does a pair come back null?

Check the ID format. It must be address:networkId with a network that Codex indexes. A token address returns null, because pairs looks up pairs only. To find a token’s pairs, use listPairsForToken or filterPairs.

How is this different from filterPairs(pairs:)?

filterPairs treats a token address in pairs as a request for that token’s top pairs, and returns ranked, filtered results with stats. pairs returns exactly the pairs you asked for, in your order, and never expands a token address.

I get OUT_OF_RANGE: Too many pairs requested

The request has more than 200 IDs. Split it into batches of 200 or fewer.