Skip to main content
GET
/
1
/
market
/
blockchain
/
pairs
Get blockchain pairs
curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/blockchain/pairs
{
  "data": [
    {
      "price": 123,
      "price_change_5min": 123,
      "price_change_1h": 123,
      "price_change_4h": 123,
      "price_change_6h": 123,
      "price_change_12h": 123,
      "price_change_24h": 123,
      "last_trade": "<string>",
      "created_at": "<string>",
      "holders_count": 123,
      "volume_1min": 123,
      "volume_5min": 123,
      "volume_15min": 123,
      "volume_1h": 123,
      "volume_4h": 123,
      "volume_6h": 123,
      "volume_12h": 123,
      "volume_24h": 123,
      "trades_1min": 123,
      "trades_5min": 123,
      "trades_15min": 123,
      "trades_1h": 123,
      "trades_4h": 123,
      "trades_6h": 123,
      "trades_12h": 123,
      "trades_24h": 123,
      "liquidity": 123,
      "pair": {
        "token0": {
          "address": "<string>",
          "chainId": "<string>",
          "symbol": "<string>",
          "name": "<string>",
          "priceTokenString": "<string>",
          "approximateReserveTokenRaw": "<string>",
          "logo": "<string>",
          "bonded_at": "<string>",
          "decimals": 0,
          "id": null,
          "price": 0,
          "priceToken": 0,
          "approximateReserveUSD": 0,
          "approximateReserveToken": 0,
          "totalSupply": 0,
          "circulatingSupply": 0,
          "marketCap": 0,
          "marketCapDiluted": 0,
          "exchange": {
            "name": "<string>",
            "logo": "<string>"
          },
          "factory": "<string>",
          "source": "<string>",
          "sourceFactory": "<string>",
          "liquidity": 123,
          "liquidityMax": 123,
          "bonded": true,
          "bondingPercentage": 123,
          "bondingCurveAddress": "<string>",
          "preBondingFactory": "<string>",
          "poolAddress": "<string>",
          "blockchain": "<string>",
          "type": "<string>",
          "tokenType": "2020",
          "is_mayhem_mode": null,
          "is_cashback_coin": null,
          "deployer": "<string>",
          "createdAt": "<string>",
          "ath": 123,
          "atl": 123,
          "athDate": "<string>",
          "atlDate": "<string>",
          "holdersCount": 123,
          "top10HoldingsPercentage": 123,
          "top50HoldingsPercentage": 123,
          "top100HoldingsPercentage": 123,
          "top200HoldingsPercentage": 123,
          "devHoldingsPercentage": 123,
          "insidersHoldingsPercentage": 123,
          "bundlersHoldingsPercentage": 123,
          "snipersHoldingsPercentage": 123,
          "proTradersHoldingsPercentage": 123,
          "freshTradersHoldingsPercentage": 123,
          "smartTradersHoldingsPercentage": 123,
          "insidersCount": 123,
          "bundlersCount": 123,
          "snipersCount": 123,
          "freshTradersCount": 123,
          "proTradersCount": 123,
          "smartTradersCount": 123,
          "freshTradersBuys": 123,
          "proTradersBuys": 123,
          "smartTradersBuys": 123
        },
        "token1": {
          "address": "<string>",
          "chainId": "<string>",
          "symbol": "<string>",
          "name": "<string>",
          "priceTokenString": "<string>",
          "approximateReserveTokenRaw": "<string>",
          "logo": "<string>",
          "bonded_at": "<string>",
          "decimals": 0,
          "id": null,
          "price": 0,
          "priceToken": 0,
          "approximateReserveUSD": 0,
          "approximateReserveToken": 0,
          "totalSupply": 0,
          "circulatingSupply": 0,
          "marketCap": 0,
          "marketCapDiluted": 0,
          "exchange": {
            "name": "<string>",
            "logo": "<string>"
          },
          "factory": "<string>",
          "source": "<string>",
          "sourceFactory": "<string>",
          "liquidity": 123,
          "liquidityMax": 123,
          "bonded": true,
          "bondingPercentage": 123,
          "bondingCurveAddress": "<string>",
          "preBondingFactory": "<string>",
          "poolAddress": "<string>",
          "blockchain": "<string>",
          "type": "<string>",
          "tokenType": "2020",
          "is_mayhem_mode": null,
          "is_cashback_coin": null,
          "deployer": "<string>",
          "createdAt": "<string>",
          "ath": 123,
          "atl": 123,
          "athDate": "<string>",
          "atlDate": "<string>",
          "holdersCount": 123,
          "top10HoldingsPercentage": 123,
          "top50HoldingsPercentage": 123,
          "top100HoldingsPercentage": 123,
          "top200HoldingsPercentage": 123,
          "devHoldingsPercentage": 123,
          "insidersHoldingsPercentage": 123,
          "bundlersHoldingsPercentage": 123,
          "snipersHoldingsPercentage": 123,
          "proTradersHoldingsPercentage": 123,
          "freshTradersHoldingsPercentage": 123,
          "smartTradersHoldingsPercentage": 123,
          "insidersCount": 123,
          "bundlersCount": 123,
          "snipersCount": 123,
          "freshTradersCount": 123,
          "proTradersCount": 123,
          "smartTradersCount": 123,
          "freshTradersBuys": 123,
          "proTradersBuys": 123,
          "smartTradersBuys": 123
        },
        "blockchain": "<string>",
        "address": "<string>",
        "createdAt": "<string>",
        "type": "<string>",
        "baseToken": "<string>",
        "exchange": {
          "name": "<string>",
          "logo": "<string>"
        },
        "factory": "<string>",
        "quoteToken": "<string>",
        "bondingPercentage": 123,
        "bondingCurveAddress": "<string>",
        "volume24h": 0,
        "liquidity": 0,
        "price": 123,
        "priceToken": 123,
        "priceTokenString": "<string>",
        "athToken0": 0,
        "athToken1": 0,
        "atlToken0": 0,
        "atlToken1": 0,
        "athDateToken0": "<string>",
        "athDateToken1": "<string>",
        "atlDateToken0": "<string>",
        "atlDateToken1": "<string>",
        "bonded": true,
        "sourceFactory": "<string>",
        "totalFeesPaidUSD": 123,
        "totalFeesPaidNativeRaw": 0,
        "extraData": {}
      },
      "source": "<string>",
      "deployer": "<string>"
    }
  ],
  "factories": {}
}
Deprecated EndpointThis endpoint is deprecated. Please use the new v2 endpoint instead:
  • /api/2/token/markets — Retrieve all markets/pairs for a token with detailed trading activity, volume, and holdings data

​
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:

FieldTypeDescription
latest_trade_datetimestamp(6)Timestamp of the most recent trade
latest_pricedouble precisionCurrent price of the asset
price_5min_agodouble precisionPrice of the asset 5 minutes ago
price_1h_agodouble precisionPrice of the asset 1 hour ago
price_4h_agodouble precisionPrice of the asset 4 hours ago
price_24h_agodouble precisionPrice of the asset 24 hours ago
price_change_5mindouble precisionPrice change in the last 5 minutes
price_change_1hdouble precisionPrice change in the last hour
price_change_4hdouble precisionPrice change in the last 4 hours
price_change_24hdouble precisionPrice change in the last 24 hours
holders_countdouble precisionNumber of token holders
latest_market_capdouble precisionCurrent market capitalization
price_1min_agodouble precisionPrice of the asset 1 minute ago
price_change_1mindouble precisionPrice change in the last minute
trades_1mindouble precisionNumber of trades in the last minute
trades_5mindouble precisionNumber of trades in the last 5 minutes
volume_1mindouble precisionTrading volume in the last minute
volume_5mindouble precisionTrading volume in the last 5 minutes
created_attimestamp(6)Creation timestamp of the record
market_capdouble precisionMarket capitalization
typetextType of the pool (uniswap-v2, uniswap-v3, etc.)

Query Parameters

​
blockchain
string

Blockchain name or chain ID

​
blockchains
string

Comma-separated blockchain IDs

​
sortBy
string

Sort field (default: latest_trade_date)

​
sortOrder
enum<string>

Sort order: asc or desc (default: desc)

Available options:
asc,
desc
​
factory
string

Filter by DEX factory address

​
limit
number | null

Number of pairs per page (max 100, default: 100)

Required range: x <= 100
​
offset
number | null

Offset for pagination (default: 0)

​
excludeBonded
boolean | null

Exclude bonded pairs (default: false)

Response

200 - application/json

Blockchain pairs response

​
data
object[]
required
​
factories
object
required