---
title: "Get market details for multiple tokens or pairs (batch)"
method: POST
path: "/api/2/market/details"
tags: ["V2 - Market Data"]
---

# Get market details for multiple tokens or pairs (batch)

`POST /api/2/market/details`

Batch variant: fetch details for multiple DEX pools in one request. Send an array of {address, blockchain} objects. Use for multi-pair dashboards or monitoring a set of liquidity pools.

## Request body

- union
  - object[]
    - `chainId` string
    - `blockchain` string
    - `address` string
    - `baseToken` string
    - `currencies` string
  - object
    - `items` object[], required
      - `chainId` string
      - `blockchain` string
      - `address` string
      - `baseToken` string
      - `currencies` string

## Response `200`

Batch market details response

- object
  - `payload` union[], required
    - union
      - object
        - `token0` object
          - `address` string, required
          - `chainId` string, required
          - `symbol` string, nullable, required
          - `name` string, nullable, required
          - `decimals` number, nullable
          - `id` number, nullable
          - `priceUSD` number, nullable
          - `priceToken` number, nullable
          - `priceTokenString` string, required
          - `approximateReserveUSD` number, nullable
          - `approximateReserveTokenRaw` string, required
          - `approximateReserveToken` number, nullable
          - `totalSupply` number, nullable
          - `circulatingSupply` number, nullable
          - `marketCapUSD` number, nullable
          - `marketCapDilutedUSD` number, nullable
          - `logo` string, nullable, required
          - `exchange` object
            - `name` string, required
            - `logo` string, required
          - `factory` string, nullable
          - `source` string, nullable
          - `sourceFactory` string, nullable
          - `sourceMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `sourceFactoryMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `liquidityUSD` number, nullable
          - `liquidityMaxUSD` number, nullable
          - `bonded` boolean
          - `bondingPercentage` number, nullable
          - `bondingCurveAddress` string, nullable
          - `preBondingFactory` string
          - `poolAddress` string
          - `blockchain` string
          - `type` string
          - `isMayhemMode` boolean, nullable
          - `isCashbackCoin` boolean, nullable
          - `isAgentMode` boolean, nullable
          - `isOGCoin` boolean, nullable
          - `deployer` string, nullable
          - `createdAt` string, nullable
          - `bondedAt` string, nullable, required
          - `athUSD` number, nullable
          - `atlUSD` number, nullable
          - `athDate` string, nullable
          - `atlDate` string, nullable
          - `holdersCount` number, nullable
          - `top10HoldingsPercentage` number, nullable
          - `top50HoldingsPercentage` number, nullable
          - `top100HoldingsPercentage` number, nullable
          - `top200HoldingsPercentage` number, nullable
          - `devHoldingsPercentage` number, nullable
          - `insidersHoldingsPercentage` number, nullable
          - `bundlersHoldingsPercentage` number, nullable
          - `snipersHoldingsPercentage` number, nullable
          - `proTradersHoldingsPercentage` number, nullable
          - `freshTradersHoldingsPercentage` number, nullable
          - `smartTradersHoldingsPercentage` number, nullable
          - `insidersCount` number, nullable
          - `bundlersCount` number, nullable
          - `snipersCount` number, nullable
          - `freshTradersCount` number, nullable
          - `proTradersCount` number, nullable
          - `smartTradersCount` number, nullable
          - `freshTradersBuys` number, nullable
          - `proTradersBuys` number, nullable
          - `smartTradersBuys` number, nullable
        - `token1` object
          - `address` string, required
          - `chainId` string, required
          - `symbol` string, nullable, required
          - `name` string, nullable, required
          - `decimals` number, nullable
          - `id` number, nullable
          - `priceUSD` number, nullable
          - `priceToken` number, nullable
          - `priceTokenString` string, required
          - `approximateReserveUSD` number, nullable
          - `approximateReserveTokenRaw` string, required
          - `approximateReserveToken` number, nullable
          - `totalSupply` number, nullable
          - `circulatingSupply` number, nullable
          - `marketCapUSD` number, nullable
          - `marketCapDilutedUSD` number, nullable
          - `logo` string, nullable, required
          - `exchange` object
            - `name` string, required
            - `logo` string, required
          - `factory` string, nullable
          - `source` string, nullable
          - `sourceFactory` string, nullable
          - `sourceMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `sourceFactoryMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `liquidityUSD` number, nullable
          - `liquidityMaxUSD` number, nullable
          - `bonded` boolean
          - `bondingPercentage` number, nullable
          - `bondingCurveAddress` string, nullable
          - `preBondingFactory` string
          - `poolAddress` string
          - `blockchain` string
          - `type` string
          - `isMayhemMode` boolean, nullable
          - `isCashbackCoin` boolean, nullable
          - `isAgentMode` boolean, nullable
          - `isOGCoin` boolean, nullable
          - `deployer` string, nullable
          - `createdAt` string, nullable
          - `bondedAt` string, nullable, required
          - `athUSD` number, nullable
          - `atlUSD` number, nullable
          - `athDate` string, nullable
          - `atlDate` string, nullable
          - `holdersCount` number, nullable
          - `top10HoldingsPercentage` number, nullable
          - `top50HoldingsPercentage` number, nullable
          - `top100HoldingsPercentage` number, nullable
          - `top200HoldingsPercentage` number, nullable
          - `devHoldingsPercentage` number, nullable
          - `insidersHoldingsPercentage` number, nullable
          - `bundlersHoldingsPercentage` number, nullable
          - `snipersHoldingsPercentage` number, nullable
          - `proTradersHoldingsPercentage` number, nullable
          - `freshTradersHoldingsPercentage` number, nullable
          - `smartTradersHoldingsPercentage` number, nullable
          - `insidersCount` number, nullable
          - `bundlersCount` number, nullable
          - `snipersCount` number, nullable
          - `freshTradersCount` number, nullable
          - `proTradersCount` number, nullable
          - `smartTradersCount` number, nullable
          - `freshTradersBuys` number, nullable
          - `proTradersBuys` number, nullable
          - `smartTradersBuys` number, nullable
        - `base` object, required
          - `address` string, required
          - `chainId` string, required
          - `symbol` string, nullable, required
          - `name` string, nullable, required
          - `decimals` number, nullable
          - `id` number, nullable
          - `priceUSD` number, nullable
          - `priceToken` number, nullable
          - `priceTokenString` string, required
          - `approximateReserveUSD` number, nullable
          - `approximateReserveTokenRaw` string, required
          - `approximateReserveToken` number, nullable
          - `totalSupply` number, nullable
          - `circulatingSupply` number, nullable
          - `marketCapUSD` number, nullable
          - `marketCapDilutedUSD` number, nullable
          - `logo` string, nullable, required
          - `exchange` object
            - `name` string, required
            - `logo` string, required
          - `factory` string, nullable
          - `source` string, nullable
          - `sourceFactory` string, nullable
          - `sourceMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `sourceFactoryMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `liquidityUSD` number, nullable
          - `liquidityMaxUSD` number, nullable
          - `bonded` boolean
          - `bondingPercentage` number, nullable
          - `bondingCurveAddress` string, nullable
          - `preBondingFactory` string
          - `poolAddress` string
          - `blockchain` string
          - `type` string
          - `isMayhemMode` boolean, nullable
          - `isCashbackCoin` boolean, nullable
          - `isAgentMode` boolean, nullable
          - `isOGCoin` boolean, nullable
          - `deployer` string, nullable
          - `createdAt` string, nullable
          - `bondedAt` string, nullable, required
          - `athUSD` number, nullable
          - `atlUSD` number, nullable
          - `athDate` string, nullable
          - `atlDate` string, nullable
          - `holdersCount` number, nullable
          - `top10HoldingsPercentage` number, nullable
          - `top50HoldingsPercentage` number, nullable
          - `top100HoldingsPercentage` number, nullable
          - `top200HoldingsPercentage` number, nullable
          - `devHoldingsPercentage` number, nullable
          - `insidersHoldingsPercentage` number, nullable
          - `bundlersHoldingsPercentage` number, nullable
          - `snipersHoldingsPercentage` number, nullable
          - `proTradersHoldingsPercentage` number, nullable
          - `freshTradersHoldingsPercentage` number, nullable
          - `smartTradersHoldingsPercentage` number, nullable
          - `insidersCount` number, nullable
          - `bundlersCount` number, nullable
          - `snipersCount` number, nullable
          - `freshTradersCount` number, nullable
          - `proTradersCount` number, nullable
          - `smartTradersCount` number, nullable
          - `freshTradersBuys` number, nullable
          - `proTradersBuys` number, nullable
          - `smartTradersBuys` number, nullable
        - `quote` object, required
          - `address` string, required
          - `chainId` string, required
          - `symbol` string, nullable, required
          - `name` string, nullable, required
          - `decimals` number, nullable
          - `id` number, nullable
          - `priceUSD` number, nullable
          - `priceToken` number, nullable
          - `priceTokenString` string, required
          - `approximateReserveUSD` number, nullable
          - `approximateReserveTokenRaw` string, required
          - `approximateReserveToken` number, nullable
          - `totalSupply` number, nullable
          - `circulatingSupply` number, nullable
          - `marketCapUSD` number, nullable
          - `marketCapDilutedUSD` number, nullable
          - `logo` string, nullable, required
          - `exchange` object
            - `name` string, required
            - `logo` string, required
          - `factory` string, nullable
          - `source` string, nullable
          - `sourceFactory` string, nullable
          - `sourceMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `sourceFactoryMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `liquidityUSD` number, nullable
          - `liquidityMaxUSD` number, nullable
          - `bonded` boolean
          - `bondingPercentage` number, nullable
          - `bondingCurveAddress` string, nullable
          - `preBondingFactory` string
          - `poolAddress` string
          - `blockchain` string
          - `type` string
          - `isMayhemMode` boolean, nullable
          - `isCashbackCoin` boolean, nullable
          - `isAgentMode` boolean, nullable
          - `isOGCoin` boolean, nullable
          - `deployer` string, nullable
          - `createdAt` string, nullable
          - `bondedAt` string, nullable, required
          - `athUSD` number, nullable
          - `atlUSD` number, nullable
          - `athDate` string, nullable
          - `atlDate` string, nullable
          - `holdersCount` number, nullable
          - `top10HoldingsPercentage` number, nullable
          - `top50HoldingsPercentage` number, nullable
          - `top100HoldingsPercentage` number, nullable
          - `top200HoldingsPercentage` number, nullable
          - `devHoldingsPercentage` number, nullable
          - `insidersHoldingsPercentage` number, nullable
          - `bundlersHoldingsPercentage` number, nullable
          - `snipersHoldingsPercentage` number, nullable
          - `proTradersHoldingsPercentage` number, nullable
          - `freshTradersHoldingsPercentage` number, nullable
          - `smartTradersHoldingsPercentage` number, nullable
          - `insidersCount` number, nullable
          - `bundlersCount` number, nullable
          - `snipersCount` number, nullable
          - `freshTradersCount` number, nullable
          - `proTradersCount` number, nullable
          - `smartTradersCount` number, nullable
          - `freshTradersBuys` number, nullable
          - `proTradersBuys` number, nullable
          - `smartTradersBuys` number, nullable
        - `liquidityUSD` number, nullable
        - `latestTradeDate` string, nullable, required
        - `blockchain` string, required
        - `address` string, required
        - `createdAt` string, nullable, required
        - `type` string, required
        - `exchange` object, required
          - `name` string, required
          - `logo` string, required
        - `factory` string, nullable, required
        - `priceUSD` number, nullable
        - `priceToken` number, nullable
        - `priceTokenString` string
        - `baseToken` string, required
        - `quoteToken` string, required
        - `bonded` boolean, nullable
        - `bondingPercentage` number, nullable, required
        - `preBondingPoolAddress` string, nullable, required
        - `sourceFactory` string, nullable
        - `totalFeesPaidUSD` number, nullable, required
        - `totalFeesPaidNativeRaw` string, nullable
        - `liquidityBurnPercentage` number, nullable
        - `priceChange1minPercentage` number, nullable
        - `priceChange5minPercentage` number, nullable
        - `priceChange1hPercentage` number, nullable
        - `priceChange4hPercentage` number, nullable
        - `priceChange6hPercentage` number, nullable
        - `priceChange12hPercentage` number, nullable
        - `priceChange24hPercentage` number, nullable
        - `volume1minUSD` number, nullable
        - `volume5minUSD` number, nullable
        - `volume15minUSD` number, nullable
        - `volume1hUSD` number, nullable
        - `volume4hUSD` number, nullable
        - `volume6hUSD` number, nullable
        - `volume12hUSD` number, nullable
        - `volume24hUSD` number, nullable
        - `volumeBuy1minUSD` number, nullable
        - `volumeBuy5minUSD` number, nullable
        - `volumeBuy15minUSD` number, nullable
        - `volumeBuy1hUSD` number, nullable
        - `volumeBuy4hUSD` number, nullable
        - `volumeBuy6hUSD` number, nullable
        - `volumeBuy12hUSD` number, nullable
        - `volumeBuy24hUSD` number, nullable
        - `volumeSell1minUSD` number, nullable
        - `volumeSell5minUSD` number, nullable
        - `volumeSell15minUSD` number, nullable
        - `volumeSell1hUSD` number, nullable
        - `volumeSell4hUSD` number, nullable
        - `volumeSell6hUSD` number, nullable
        - `volumeSell12hUSD` number, nullable
        - `volumeSell24hUSD` number, nullable
        - `trades1min` number, nullable
        - `trades5min` number, nullable
        - `trades15min` number, nullable
        - `trades1h` number, nullable
        - `trades4h` number, nullable
        - `trades6h` number, nullable
        - `trades12h` number, nullable
        - `trades24h` number, nullable
        - `buys1min` number, nullable
        - `buys5min` number, nullable
        - `buys15min` number, nullable
        - `buys1h` number, nullable
        - `buys4h` number, nullable
        - `buys6h` number, nullable
        - `buys12h` number, nullable
        - `buys24h` number, nullable
        - `sells1min` number, nullable
        - `sells5min` number, nullable
        - `sells15min` number, nullable
        - `sells1h` number, nullable
        - `sells4h` number, nullable
        - `sells6h` number, nullable
        - `sells12h` number, nullable
        - `sells24h` number, nullable
        - `buyers1min` number, nullable
        - `buyers5min` number, nullable
        - `buyers15min` number, nullable
        - `buyers1h` number, nullable
        - `buyers4h` number, nullable
        - `buyers6h` number, nullable
        - `buyers12h` number, nullable
        - `buyers24h` number, nullable
        - `sellers1min` number, nullable
        - `sellers5min` number, nullable
        - `sellers15min` number, nullable
        - `sellers1h` number, nullable
        - `sellers4h` number, nullable
        - `sellers6h` number, nullable
        - `sellers12h` number, nullable
        - `sellers24h` number, nullable
        - `traders1min` number, nullable
        - `traders5min` number, nullable
        - `traders15min` number, nullable
        - `traders1h` number, nullable
        - `traders4h` number, nullable
        - `traders6h` number, nullable
        - `traders12h` number, nullable
        - `traders24h` number, nullable
        - `feesPaid1minUSD` number, nullable
        - `feesPaid5minUSD` number, nullable
        - `feesPaid15minUSD` number, nullable
        - `feesPaid1hUSD` number, nullable
        - `feesPaid4hUSD` number, nullable
        - `feesPaid6hUSD` number, nullable
        - `feesPaid12hUSD` number, nullable
        - `feesPaid24hUSD` number, nullable
        - `holdersCount` number, nullable
        - `source` string, nullable, required
        - `deployer` string, nullable, required
        - `tokenSymbol` string, nullable, required
        - `tokenName` string, nullable, required
        - `dexscreenerListed` boolean, nullable
        - `deployerMigrations` number, nullable
        - `socials` object, required
          - `twitter` string, nullable, required
          - `website` string, nullable, required
          - `telegram` string, nullable, required
          - `others` object, nullable, required
          - `uri` string
        - `description` string, nullable, required
        - `security` object, nullable, required
          - `buyTax` string, nullable
          - `sellTax` string, nullable
          - `transferPausable` boolean
          - `top10Holders` string
          - `isBlacklisted` boolean
          - `noMintAuthority` boolean
          - `balanceMutable` boolean
          - `lowLiquidity` string
          - `burnRate` string
          - `liquidityBurnPercentage` number
          - `isHoneypot` boolean
          - `isNotOpenSource` boolean
          - `renounced` boolean
          - `locked` string
          - `isWhitelisted` boolean
          - `isMintable` boolean
          - `modifyableTax` boolean
          - `selfDestruct` boolean
        - `twitterReusesCount` number, nullable
        - `twitterRenameCount` number, nullable
        - `twitterRenameHistory` object[]
          - `username` string, required
          - `lastChecked` string, required
        - `perpetuals` object
          - `markPriceUSD` number, nullable
          - `markPriceQuote` number, nullable
          - `oraclePriceUSD` number, nullable
          - `isDisabled` boolean, nullable
          - `isOpen` boolean, nullable
          - `assetClass` string, required
          - `spreadPercentage` number, nullable
          - `fundingFeeShort1hPercentage` number, nullable
          - `totalFeeShort1hPercentage` number, nullable
          - `fundingFeeLong1hPercentage` number, nullable
          - `totalFeeLong1hPercentage` number, nullable
          - `fundingFeeShort8hPercentage` number, nullable
          - `totalFeeShort8hPercentage` number, nullable
          - `fundingFeeLong8hPercentage` number, nullable
          - `totalFeeLong8hPercentage` number, nullable
          - `fundingFeeShort24hPercentage` number, nullable
          - `totalFeeShort24hPercentage` number, nullable
          - `fundingFeeLong24hPercentage` number, nullable
          - `totalFeeLong24hPercentage` number, nullable
          - `fundingFeeShort1yPercentage` number, nullable
          - `totalFeeShort1yPercentage` number, nullable
          - `fundingFeeLong1yPercentage` number, nullable
          - `totalFeeLong1yPercentage` number, nullable
          - `collateral` string
          - `marketId` string, required
          - `defaultTradingFees` object, required
            - `makerFeeBps` number
            - `takerFeeBps` number
          - `leverage` object, required
            - `min` number
            - `max` number
          - `liquidationParams` object, required
            - `maxLiqSpreadPercentage` number
            - `startLiqThresholdPercentage` number
            - `endLiqThresholdPercentage` number
            - `startLeverage` number
            - `endLeverage` number
          - `openInterest` object, required
            - `longUSD` number
            - `longQuoteToken` number
            - `shortUSD` number
            - `shortQuoteToken` number
            - `maxUSD` number
            - `maxQuoteToken` number
        - `extraData` object
        - `top10HoldingsPercentage` number, nullable
        - `top50HoldingsPercentage` number, nullable
        - `top100HoldingsPercentage` number, nullable
        - `top200HoldingsPercentage` number, nullable
        - `devHoldingsPercentage` number, nullable
        - `insidersHoldingsPercentage` number, nullable
        - `bundlersHoldingsPercentage` number, nullable
        - `snipersHoldingsPercentage` number, nullable
        - `proTradersHoldingsPercentage` number, nullable
        - `freshTradersHoldingsPercentage` number, nullable
        - `smartTradersHoldingsPercentage` number, nullable
        - `insidersCount` number, nullable
        - `bundlersCount` number, nullable
        - `snipersCount` number, nullable
        - `freshTradersCount` number, nullable
        - `proTradersCount` number, nullable
        - `smartTradersCount` number, nullable
        - `freshTradersBuys` number, nullable
        - `proTradersBuys` number, nullable
        - `smartTradersBuys` number, nullable
      - object
        - `error` string
      - unknown
  - `hostname` string

## Other responses

- `402` — Payment Required

---

[API](https://skmtc.net/mobula/apis/mobula-api.md) · [All operations](https://skmtc.net/mobula/apis/mobula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobula/mobula-api/versions/32f95d9e8ff2/schema)
