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": "<unknown>",
          "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>",
          "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": "<unknown>",
          "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>",
          "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
      },
      "source": "<string>",
      "deployer": "<string>"
    }
  ],
  "factories": {}
}

​
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
​
blockchains
string
​
sortBy
string
default:latest_trade_date
​
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
​
factory
string
​
limit
number | null
default:100
Required range: x <= 100
​
offset
number | null
default:0
​
advancedFilters
string
​
filters
string
​
excludeBonded
boolean | null
default:false

Response

200 - application/json

Blockchain pairs response

​
data
object[]
required
​
factories
object
required