> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Blockchain Pairs

<Warning>
  **Deprecated Endpoint**

  This endpoint is deprecated. Please use the new v2 endpoint instead:

  * [/api/2/token/markets](/rest-api-reference/endpoint/token-markets) — Retrieve all markets/pairs for a token with detailed trading activity, volume, and holdings data
</Warning>

### Query details:

This endpoint returns **all trading pairs** on a **specified blockchain**, providing detailed market data and metrics for each pair. Use it to explore the full set of pairs available on a blockchain regardless of any specific token.

* The response data is enriched with detailed **pulse metrics**, including price history, trade volume, liquidity, holder counts, and pool types.
* Filter parameters support range filtering using the format:
  * `field:minValue:maxValue` `eg: market_cap:100000:1000000` filters pairs with market caps between 100,000 and 1,000,000.

#### Possible filters & sort fields:

| Field               | Type             | Description                                     |
| ------------------- | ---------------- | ----------------------------------------------- |
| latest\_trade\_date | timestamp(6)     | Timestamp of the most recent trade              |
| latest\_price       | double precision | Current price of the asset                      |
| price\_5min\_ago    | double precision | Price of the asset 5 minutes ago                |
| price\_1h\_ago      | double precision | Price of the asset 1 hour ago                   |
| price\_4h\_ago      | double precision | Price of the asset 4 hours ago                  |
| price\_24h\_ago     | double precision | Price of the asset 24 hours ago                 |
| price\_change\_5min | double precision | Price change in the last 5 minutes              |
| price\_change\_1h   | double precision | Price change in the last hour                   |
| price\_change\_4h   | double precision | Price change in the last 4 hours                |
| price\_change\_24h  | double precision | Price change in the last 24 hours               |
| holders\_count      | double precision | Number of token holders                         |
| latest\_market\_cap | double precision | Current market capitalization                   |
| price\_1min\_ago    | double precision | Price of the asset 1 minute ago                 |
| price\_change\_1min | double precision | Price change in the last minute                 |
| trades\_1min        | double precision | Number of trades in the last minute             |
| trades\_5min        | double precision | Number of trades in the last 5 minutes          |
| volume\_1min        | double precision | Trading volume in the last minute               |
| volume\_5min        | double precision | Trading volume in the last 5 minutes            |
| created\_at         | timestamp(6)     | Creation timestamp of the record                |
| market\_cap         | double precision | Market capitalization                           |
| type                | text             | Type of the pool (uniswap-v2, uniswap-v3, etc.) |


## OpenAPI

````yaml get /1/market/blockchain/pairs
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /1/market/blockchain/pairs:
    get:
      tags:
        - V1 - Blockchains
      summary: Get blockchain pairs
      parameters:
        - schema:
            type: string
            description: Blockchain name or chain ID
          required: false
          description: Blockchain name or chain ID
          name: blockchain
          in: query
        - schema:
            type: string
            description: Comma-separated blockchain IDs
          required: false
          description: Comma-separated blockchain IDs
          name: blockchains
          in: query
        - schema:
            type: string
            description: 'Sort field (default: latest_trade_date)'
          required: false
          description: 'Sort field (default: latest_trade_date)'
          name: sortBy
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
            description: 'Sort order: asc or desc (default: desc)'
          required: false
          description: 'Sort order: asc or desc (default: desc)'
          name: sortOrder
          in: query
        - schema:
            type: string
            description: Filter by DEX factory address
          required: false
          description: Filter by DEX factory address
          name: factory
          in: query
        - schema:
            type: number
            nullable: true
            maximum: 100
            description: 'Number of pairs per page (max 100, default: 100)'
          required: false
          description: 'Number of pairs per page (max 100, default: 100)'
          name: limit
          in: query
        - schema:
            type: number
            nullable: true
            description: 'Offset for pagination (default: 0)'
          required: false
          description: 'Offset for pagination (default: 0)'
          name: offset
          in: query
        - schema:
            type: boolean
            nullable: true
            description: 'Exclude bonded pairs (default: false)'
          required: false
          description: 'Exclude bonded pairs (default: false)'
          name: excludeBonded
          in: query
      responses:
        '200':
          description: Blockchain pairs response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        price:
                          type: number
                        price_change_5min:
                          type: number
                        price_change_1h:
                          type: number
                        price_change_4h:
                          type: number
                        price_change_6h:
                          type: number
                        price_change_12h:
                          type: number
                        price_change_24h:
                          type: number
                        last_trade:
                          type: string
                          nullable: true
                        created_at:
                          type: string
                          nullable: true
                        holders_count:
                          type: number
                        volume_1min:
                          type: number
                        volume_5min:
                          type: number
                        volume_15min:
                          type: number
                        volume_1h:
                          type: number
                        volume_4h:
                          type: number
                        volume_6h:
                          type: number
                        volume_12h:
                          type: number
                        volume_24h:
                          type: number
                        trades_1min:
                          type: number
                        trades_5min:
                          type: number
                        trades_15min:
                          type: number
                        trades_1h:
                          type: number
                        trades_4h:
                          type: number
                        trades_6h:
                          type: number
                        trades_12h:
                          type: number
                        trades_24h:
                          type: number
                        liquidity:
                          type: number
                        pair:
                          type: object
                          properties:
                            token0:
                              type: object
                              properties:
                                address:
                                  type: string
                                chainId:
                                  type: string
                                symbol:
                                  type: string
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                                decimals:
                                  type: number
                                  nullable: true
                                  default: 0
                                id:
                                  type: number
                                  nullable: true
                                  default: null
                                price:
                                  type: number
                                  nullable: true
                                  default: 0
                                priceToken:
                                  type: number
                                  nullable: true
                                  default: 0
                                priceTokenString:
                                  type: string
                                approximateReserveUSD:
                                  type: number
                                  nullable: true
                                  default: 0
                                approximateReserveTokenRaw:
                                  type: string
                                approximateReserveToken:
                                  type: number
                                  nullable: true
                                  default: 0
                                totalSupply:
                                  type: number
                                  nullable: true
                                  default: 0
                                circulatingSupply:
                                  type: number
                                  nullable: true
                                  default: 0
                                marketCap:
                                  type: number
                                  nullable: true
                                  default: 0
                                marketCapDiluted:
                                  type: number
                                  nullable: true
                                  default: 0
                                logo:
                                  type: string
                                  nullable: true
                                exchange:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    logo:
                                      type: string
                                  required:
                                    - name
                                    - logo
                                factory:
                                  type: string
                                  nullable: true
                                source:
                                  type: string
                                  nullable: true
                                sourceFactory:
                                  type: string
                                  nullable: true
                                liquidity:
                                  type: number
                                  nullable: true
                                liquidityMax:
                                  type: number
                                  nullable: true
                                bonded:
                                  type: boolean
                                bondingPercentage:
                                  type: number
                                  nullable: true
                                bondingCurveAddress:
                                  type: string
                                  nullable: true
                                preBondingFactory:
                                  type: string
                                poolAddress:
                                  type: string
                                blockchain:
                                  type: string
                                type:
                                  type: string
                                tokenType:
                                  type: string
                                  nullable: true
                                  enum:
                                    - '2020'
                                    - '2022'
                                is_mayhem_mode:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_cashback_coin:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_agent_mode:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_og_coin:
                                  type: boolean
                                  nullable: true
                                  default: null
                                deployer:
                                  type: string
                                  nullable: true
                                createdAt:
                                  type: string
                                bonded_at:
                                  type: string
                                  nullable: true
                                ath:
                                  type: number
                                  nullable: true
                                atl:
                                  type: number
                                  nullable: true
                                athDate:
                                  type: string
                                  nullable: true
                                atlDate:
                                  type: string
                                  nullable: true
                                holdersCount:
                                  type: number
                                  nullable: true
                                top10HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top50HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top100HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top200HoldingsPercentage:
                                  type: number
                                  nullable: true
                                devHoldingsPercentage:
                                  type: number
                                  nullable: true
                                insidersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                bundlersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                snipersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                proTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                freshTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                smartTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                insidersCount:
                                  type: number
                                  nullable: true
                                bundlersCount:
                                  type: number
                                  nullable: true
                                snipersCount:
                                  type: number
                                  nullable: true
                                freshTradersCount:
                                  type: number
                                  nullable: true
                                proTradersCount:
                                  type: number
                                  nullable: true
                                smartTradersCount:
                                  type: number
                                  nullable: true
                                freshTradersBuys:
                                  type: number
                                  nullable: true
                                proTradersBuys:
                                  type: number
                                  nullable: true
                                smartTradersBuys:
                                  type: number
                                  nullable: true
                              required:
                                - address
                                - chainId
                                - symbol
                                - name
                                - priceTokenString
                                - approximateReserveTokenRaw
                                - logo
                                - bonded_at
                            token1:
                              type: object
                              properties:
                                address:
                                  type: string
                                chainId:
                                  type: string
                                symbol:
                                  type: string
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                                decimals:
                                  type: number
                                  nullable: true
                                  default: 0
                                id:
                                  type: number
                                  nullable: true
                                  default: null
                                price:
                                  type: number
                                  nullable: true
                                  default: 0
                                priceToken:
                                  type: number
                                  nullable: true
                                  default: 0
                                priceTokenString:
                                  type: string
                                approximateReserveUSD:
                                  type: number
                                  nullable: true
                                  default: 0
                                approximateReserveTokenRaw:
                                  type: string
                                approximateReserveToken:
                                  type: number
                                  nullable: true
                                  default: 0
                                totalSupply:
                                  type: number
                                  nullable: true
                                  default: 0
                                circulatingSupply:
                                  type: number
                                  nullable: true
                                  default: 0
                                marketCap:
                                  type: number
                                  nullable: true
                                  default: 0
                                marketCapDiluted:
                                  type: number
                                  nullable: true
                                  default: 0
                                logo:
                                  type: string
                                  nullable: true
                                exchange:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    logo:
                                      type: string
                                  required:
                                    - name
                                    - logo
                                factory:
                                  type: string
                                  nullable: true
                                source:
                                  type: string
                                  nullable: true
                                sourceFactory:
                                  type: string
                                  nullable: true
                                liquidity:
                                  type: number
                                  nullable: true
                                liquidityMax:
                                  type: number
                                  nullable: true
                                bonded:
                                  type: boolean
                                bondingPercentage:
                                  type: number
                                  nullable: true
                                bondingCurveAddress:
                                  type: string
                                  nullable: true
                                preBondingFactory:
                                  type: string
                                poolAddress:
                                  type: string
                                blockchain:
                                  type: string
                                type:
                                  type: string
                                tokenType:
                                  type: string
                                  nullable: true
                                  enum:
                                    - '2020'
                                    - '2022'
                                is_mayhem_mode:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_cashback_coin:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_agent_mode:
                                  type: boolean
                                  nullable: true
                                  default: null
                                is_og_coin:
                                  type: boolean
                                  nullable: true
                                  default: null
                                deployer:
                                  type: string
                                  nullable: true
                                createdAt:
                                  type: string
                                bonded_at:
                                  type: string
                                  nullable: true
                                ath:
                                  type: number
                                  nullable: true
                                atl:
                                  type: number
                                  nullable: true
                                athDate:
                                  type: string
                                  nullable: true
                                atlDate:
                                  type: string
                                  nullable: true
                                holdersCount:
                                  type: number
                                  nullable: true
                                top10HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top50HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top100HoldingsPercentage:
                                  type: number
                                  nullable: true
                                top200HoldingsPercentage:
                                  type: number
                                  nullable: true
                                devHoldingsPercentage:
                                  type: number
                                  nullable: true
                                insidersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                bundlersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                snipersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                proTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                freshTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                smartTradersHoldingsPercentage:
                                  type: number
                                  nullable: true
                                insidersCount:
                                  type: number
                                  nullable: true
                                bundlersCount:
                                  type: number
                                  nullable: true
                                snipersCount:
                                  type: number
                                  nullable: true
                                freshTradersCount:
                                  type: number
                                  nullable: true
                                proTradersCount:
                                  type: number
                                  nullable: true
                                smartTradersCount:
                                  type: number
                                  nullable: true
                                freshTradersBuys:
                                  type: number
                                  nullable: true
                                proTradersBuys:
                                  type: number
                                  nullable: true
                                smartTradersBuys:
                                  type: number
                                  nullable: true
                              required:
                                - address
                                - chainId
                                - symbol
                                - name
                                - priceTokenString
                                - approximateReserveTokenRaw
                                - logo
                                - bonded_at
                            volume24h:
                              type: number
                              nullable: true
                              default: 0
                            liquidity:
                              type: number
                              nullable: true
                              default: 0
                            blockchain:
                              type: string
                            address:
                              type: string
                            createdAt:
                              type: string
                              nullable: true
                            type:
                              type: string
                            baseToken:
                              type: string
                            exchange:
                              type: object
                              properties:
                                name:
                                  type: string
                                logo:
                                  type: string
                              required:
                                - name
                                - logo
                            factory:
                              type: string
                              nullable: true
                            quoteToken:
                              type: string
                            price:
                              type: number
                              nullable: true
                            priceToken:
                              type: number
                              nullable: true
                            priceTokenString:
                              type: string
                            athToken0:
                              type: number
                              nullable: true
                              default: 0
                            athToken1:
                              type: number
                              nullable: true
                              default: 0
                            atlToken0:
                              type: number
                              nullable: true
                              default: 0
                            atlToken1:
                              type: number
                              nullable: true
                              default: 0
                            athDateToken0:
                              type: string
                              nullable: true
                            athDateToken1:
                              type: string
                              nullable: true
                            atlDateToken0:
                              type: string
                              nullable: true
                            atlDateToken1:
                              type: string
                              nullable: true
                            bonded:
                              type: boolean
                              nullable: true
                            bondingPercentage:
                              type: number
                              nullable: true
                            bondingCurveAddress:
                              type: string
                              nullable: true
                            sourceFactory:
                              type: string
                              nullable: true
                            totalFeesPaidUSD:
                              type: number
                              nullable: true
                            totalFeesPaidNativeRaw:
                              type: string
                              pattern: ^d+$
                              default: 0
                            extraData:
                              type: object
                              additionalProperties:
                                nullable: true
                          required:
                            - token0
                            - token1
                            - blockchain
                            - address
                            - createdAt
                            - type
                            - baseToken
                            - exchange
                            - factory
                            - quoteToken
                            - bondingPercentage
                            - bondingCurveAddress
                        source:
                          type: string
                          nullable: true
                        deployer:
                          type: string
                          nullable: true
                      required:
                        - price
                        - price_change_5min
                        - price_change_1h
                        - price_change_4h
                        - price_change_6h
                        - price_change_12h
                        - price_change_24h
                        - last_trade
                        - created_at
                        - holders_count
                        - volume_1min
                        - volume_5min
                        - volume_15min
                        - volume_1h
                        - volume_4h
                        - volume_6h
                        - volume_12h
                        - volume_24h
                        - trades_1min
                        - trades_5min
                        - trades_15min
                        - trades_1h
                        - trades_4h
                        - trades_6h
                        - trades_12h
                        - trades_24h
                        - liquidity
                        - pair
                        - source
                        - deployer
                  factories:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - data
                  - factories

````