> ## 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 Market Data (batch)
> Get market data for multiple crypto token
**Deprecated Endpoint**
This endpoint is deprecated. Please use the new v2 endpoints instead:
* [/api/2/asset/details (POST)](/rest-api-reference/endpoint/asset-details#post-method-batch-query) — Batch asset-level data for multiple assets in a single request
* [/api/2/token/details (POST)](/rest-api-reference/endpoint/token-details#post-method-batch-query) — Batch token-level data for multiple tokens in a single request
### Query details
Input in "asset" the name of the asset you want to query, or the contract address while adding the blockchain as a second parameter. The market data asset query pattern is explained [in great details here](/rest-api-reference/docs/market-asset-query), with blockchain format, etc.
| Parameter | Type | Required | Description |
| ------------------------ | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| `asset` | string | Yes | The asset identifier to query. This can be the token’s name or the contract address. |
| `blockchain` | string | Cond. | The blockchain network name or ID where the asset resides. Required if querying by contract address. |
| `shouldFetchPriceChange` | string | No | Timeframe for price change calculation. Example: `"24h"` returns price change over the last 24 hours. |
| `symbol` | string | Cond. | Token ticker symbol. If duplicates exist, returns the first match. Use contract + blockchain for accuracy. |
| `ids` | number | Cond. | The Asset Unique Identifier to query. |
You can submit multiple assets and blockchains as comma-separated lists. The API matches each asset with the corresponding blockchain by their order in the lists — the first blockchain maps to the first asset, the second to the second, and so forth.
Need more than 500 assets? You can use the [/all](/rest-api-reference/endpoint/all)
endpoint to get all assets listed on Mobula (curated, not all DeFi tokens)
You can also query by token symbols alone. In cases where multiple assets share the same symbol, Mobula returns the asset with the highest market capitalization. This feature is especially useful when mapping data from **centralized exchange (CEX)** trading pairs. When using symbols for queries, specifying asset parameters is optional.
### Data details
Price data is computed using Octopus, Mobula's market data engine. You can have a high-level overview of how it's computing DeFi prices [here](https://mirror.xyz/0x6483Ca5ac1EbC6eB08d36979d217db2572CbAad2/Lw8NSSjqR4JSzthKZQCfHLwD3NPGsuaAfHGMY1zi-WI). `volume` is on-chain volume, and `off_chain_volume` is - as name implies, the off-chain volume.
### Usage Examples
* Query by Symbols and Blockchain
```bash theme={null}
curl -X GET "https://api.mobula.io/api/1/market/multi-data?symbols=PEPE,CULT&blockchains=ethereum,ethereum"
```
* Query by Contract Address of Token.
```bash theme={null}
curl -X GET "https://api.mobula.io/api/1/market/multi-data?assets=0x0000000000c5dc95539589fbd24be07c6c14eca4,0x6982508145454ce325ddbe47a25d4ec3d2311933&blockchains=ethereum,ethereum"
```
* Query by Query Native Token. (ETH,SOL)
```bash theme={null}
curl -X GET "https://api.mobula.io/api/1/market/multi-data?assets=0xEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE,0xEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE&blockchains=ethereum,solana"
```
* Query by Asset ids.
```bash theme={null}
curl -X GET "https://api.mobula.io/api/1/market/data?shouldFetchPriceChange=24h&id=100"
```
## OpenAPI
````yaml get /1/market/multi-data
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 - Usage
description: Per-key API and WebSocket usage history
- name: V2 - Blockchains
description: System metadata and chain listings
- name: V2 - Prediction Markets
description: >-
Polymarket markets/events, wallet positions, and the full execution stack
(auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy,
deposit/withdraw, redeem). Alpha — see /api/2/pm/*.
- 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/multi-data:
get:
tags:
- V1 - Market Data
summary: Get market multi data
parameters:
- schema:
anyOf:
- type: string
- type: array
items:
type: string
description: Comma-separated asset IDs
required: false
description: Comma-separated asset IDs
name: ids
in: query
- schema:
anyOf:
- type: string
- type: array
items:
type: string
description: Comma-separated token symbols
required: false
description: Comma-separated token symbols
name: symbols
in: query
- schema:
anyOf:
- type: string
- type: array
items:
type: string
description: Comma-separated blockchain IDs
required: false
description: Comma-separated blockchain IDs
name: blockchains
in: query
- schema:
anyOf:
- type: string
- type: array
items:
type: object
properties:
type:
type: string
enum:
- address
- name
value:
type: string
required:
- type
- value
description: Comma-separated token addresses or names
required: false
description: Comma-separated token addresses or names
name: assets
in: query
responses:
'200':
description: Market multi data response
content:
application/json:
schema:
type: object
properties:
data:
type: object
additionalProperties:
type: object
properties:
key:
type: string
id:
type: number
nullable: true
name:
type: string
symbol:
type: string
decimals:
type: number
nullable: true
logo:
type: string
nullable: true
rank:
type: number
nullable: true
price:
type: number
nullable: true
market_cap:
type: number
market_cap_diluted:
type: number
volume:
type: number
volume_change_24h:
type: number
volume_7d:
type: number
liquidity:
type: number
ath:
type: number
nullable: true
atl:
type: number
nullable: true
off_chain_volume:
type: number
is_listed:
type: boolean
price_change_1h:
type: number
price_change_24h:
type: number
price_change_7d:
type: number
price_change_1m:
type: number
price_change_1y:
type: number
total_supply:
type: number
circulating_supply:
type: number
contracts:
type: array
items:
type: object
properties:
address:
type: string
blockchainId:
type: string
blockchain:
type: string
decimals:
type: number
required:
- address
- blockchainId
- blockchain
- decimals
required:
- key
- id
- name
- symbol
- decimals
- logo
- rank
- price
- market_cap
- market_cap_diluted
- volume
- volume_change_24h
- volume_7d
- liquidity
- ath
- atl
- off_chain_volume
- is_listed
- price_change_1h
- price_change_24h
- price_change_7d
- price_change_1m
- price_change_1y
- total_supply
- circulating_supply
- contracts
dataArray:
type: array
items:
type: object
nullable: true
properties:
key:
type: string
id:
type: number
nullable: true
name:
type: string
symbol:
type: string
decimals:
type: number
nullable: true
logo:
type: string
nullable: true
rank:
type: number
nullable: true
price:
type: number
nullable: true
market_cap:
type: number
market_cap_diluted:
type: number
volume:
type: number
volume_change_24h:
type: number
volume_7d:
type: number
liquidity:
type: number
ath:
type: number
nullable: true
atl:
type: number
nullable: true
off_chain_volume:
type: number
is_listed:
type: boolean
price_change_1h:
type: number
price_change_24h:
type: number
price_change_7d:
type: number
price_change_1m:
type: number
price_change_1y:
type: number
total_supply:
type: number
circulating_supply:
type: number
contracts:
type: array
items:
type: object
properties:
address:
type: string
blockchainId:
type: string
blockchain:
type: string
decimals:
type: number
required:
- address
- blockchainId
- blockchain
- decimals
required:
- key
- id
- name
- symbol
- decimals
- logo
- rank
- price
- market_cap
- market_cap_diluted
- volume
- volume_change_24h
- volume_7d
- liquidity
- ath
- atl
- off_chain_volume
- is_listed
- price_change_1h
- price_change_24h
- price_change_7d
- price_change_1m
- price_change_1y
- total_supply
- circulating_supply
- contracts
required:
- data
- dataArray
````