Skip to main content
GET
List Markets

Authorizations

X-Blockworks-API-Key
string
header
required

API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models open to everyone need no key.

Query Parameters

marketIDEq
string

Market ID equals.

marketIDIsOneOf
string[]

Market ID is one of (comma-separated).

baseAssetIDEq
string

Base Asset ID equals.

baseAssetIDIsOneOf
string[]

Base Asset ID is one of (comma-separated).

baseAssetSlugEq
string

Base Asset Slug equals.

baseAssetSlugIsOneOf
string[]

Base Asset Slug is one of (comma-separated).

quoteAssetIDEq
string

Quote Asset ID equals.

quoteAssetIDIsOneOf
string[]

Quote Asset ID is one of (comma-separated).

quoteAssetSlugEq
string

Quote Asset Slug equals.

quoteAssetSlugIsOneOf
string[]

Quote Asset Slug is one of (comma-separated).

exchangeIDEq
string

Exchange ID equals.

exchangeIDIsOneOf
string[]

Exchange ID is one of (comma-separated).

exchangeSlugEq
string

Exchange Slug equals.

exchangeSlugIsOneOf
string[]

Exchange Slug is one of (comma-separated).

lastTradeAtGt
string<date-time>

Last Trade At is greater than.

lastTradeAtGte
string<date-time>

Last Trade At is greater than or equal to.

livenessEq
string

Liveness equals.

livenessIsOneOf
string[]

Liveness is one of (comma-separated).

volume24hUSDGt
number

Volume 24H USD is greater than.

volume24hUSDGte
number

Volume 24H USD is greater than or equal to.

volume24hUSDLt
number

Volume 24H USD is less than.

volume24hUSDLte
number

Volume 24H USD is less than or equal to.

sortBy
enum<string>
default:volume24hUSD

Field to sort by; defaults to the model's default sort column.

Available options:
firstTradeAt,
lastTradeAt,
latestPrice24hOpen,
latestPrice24hHigh,
latestPrice24hLow,
latestPrice24hClose,
premiumDiscount,
exchangeVolumePercentage24h,
volume24hUSD,
tradeCount24h
sortDirection
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
page
integer

1-based page number.

pageSize
integer

Rows per page (max 1000, default 100).

selections
enum<string>[]

Comma-separated fields to return; defaults to all fields.

Available options:
marketID,
baseAssetID,
baseAssetName,
baseAssetSlug,
baseAssetSymbol,
baseAssetSector,
quoteAssetID,
quoteAssetName,
quoteAssetSlug,
quoteAssetSymbol,
quoteAssetSector,
exchangeID,
exchangeName,
exchangeSlug,
networkID,
networkName,
networkSlug,
sectors,
firstTradeAt,
lastTradeAt,
isNewMarket,
isRecentlyListed,
liveness,
latestPrice24hOpen,
latestPrice24hHigh,
latestPrice24hLow,
latestPrice24hClose,
premiumDiscount,
exchangeVolumePercentage24h,
volume24hUSD,
tradeCount24h
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

One page of matching rows, with the totals for the whole filtered set.

data
object[]
required
metadata
object
required

Pagination totals for the full filtered result set, independent of the current page.

error
string | null