Market (BQEN)

Every trading pair with its base asset, quote asset, exchange and network, plus trailing 24-hour price and volume. The id is the series key of the bqen and markets timeseries models, so this is where you find the market whose candles you want: filter by base asset, quote asset or exchange.


Access	Markets-dataset
Tabular model	`markets`: primary key `marketID`
Timeseries model	`bqen`: intervals `5m`, `1h`, `1d`, `1w`, series key `id` (Market ID), series must be named (up to 10 per call)

Endpoints

List Markets

One page of rows with per-column filters, sorting and pagination.

Get Market

One row by marketID.

Batch Get Market timeseries

Up to 10 series in one request, named by Market ID in series.

Get Market timeseries

One series over a time window, keyed by its Market ID.

Metrics

10 metrics. Use the Field value in selections; every point starts with the timestamp and continues in this order.

Field	Name	Type	Unit	Description
`open-price`	Open Price	float64	usd	USD price at the candle open.
`open-price-raw`	Open Price Raw	float64	usd	Raw price at the candle open.
`high-price`	High Price	float64	usd	High USD price during the candle.
`high-price-raw`	High Price Raw	float64	usd	Raw high price during the candle.
`low-price`	Low Price	float64	usd	Low USD price during the candle.
`low-price-raw`	Low Price Raw	float64	usd	Raw low price during the candle.
`close-price`	Close Price	float64	usd	USD price at the candle close.
`close-price-raw`	Close Price Raw	float64	usd	Raw price at the candle close.
`volume`	Volume	float64	usd	Volume traded during candle.
`volume-raw`	Volume Raw	float64	usd	Raw volume traded during candle.

Columns

Use the Field value in selections, sortBy, and as the base of a filter parameter (Field plus one of its Filters suffixes).

Field	Type	Filters	Sort	Description
`marketID`	string	`Eq`, `IsOneOf`		The unique identifier of the market, and the series key of the bqen and markets timeseries models. It joins the serial identifiers of the base asset, quote asset and exchange, and adds the network on an onchain market. 6057-140-68 is BTC/USDT on Binance; 6071-6083-84-9 is WETH/USDC on Uniswap v3 on Ethereum. (primary key)
`baseAssetID`	string	`Eq`, `IsOneOf`		The unique identifier of the market’s base asset.
`baseAssetName`	string			The name of the market’s base asset.
`baseAssetSlug`	string	`Eq`, `IsOneOf`		The URL slug of the market’s base asset.
`baseAssetSymbol`	string			The ticker symbol of the market’s base asset.
`baseAssetSector`	string			The sector of the market’s base asset.
`quoteAssetID`	string	`Eq`, `IsOneOf`		The unique identifier of the market’s quote asset.
`quoteAssetName`	string			The name of the market’s quote asset.
`quoteAssetSlug`	string	`Eq`, `IsOneOf`		The URL slug of the market’s quote asset.
`quoteAssetSymbol`	string			The ticker symbol of the market’s quote asset.
`quoteAssetSector`	string			The sector of the market’s quote asset.
`exchangeID`	string	`Eq`, `IsOneOf`		The unique identifier of the exchange the market trades on.
`exchangeName`	string			The name of the exchange the market trades on.
`exchangeSlug`	string	`Eq`, `IsOneOf`		The URL slug of the exchange the market trades on.
`networkID`	string			The unique identifier of the network the market settles on. Absent for markets that are not onchain.
`networkName`	string			The name of the network the market settles on.
`networkSlug`	string			The URL slug of the network the market settles on.
`sectors`	array_string			The sectors covering the market’s assets.
`firstTradeAt`	time		yes	When the market’s first trade was recorded.
`lastTradeAt`	time	`Gt`, `Gte`	yes	When the market’s most recent trade was recorded. Filtering on this selects markets active since a given time.
`isNewMarket`	bool			If true, the market was listed recently enough to count as new.
`isRecentlyListed`	bool			If true, the market’s asset was listed recently.
`liveness`	string	`Eq`, `IsOneOf`		Trading state of the market. One of live, low-volume, or inactive. The public API renders low-volume as stale.
`latestPrice24hOpen`	float64		yes	Opening price over the trailing 24 hours, in USD.
`latestPrice24hHigh`	float64		yes	Highest price over the trailing 24 hours, in USD.
`latestPrice24hLow`	float64		yes	Lowest price over the trailing 24 hours, in USD.
`latestPrice24hClose`	float64		yes	Closing price over the trailing 24 hours, in USD.
`premiumDiscount`	float64		yes	The market’s price relative to the reference price of its base asset.
`exchangeVolumePercentage24h`	float64		yes	Share of the exchange’s trailing 24-hour volume this market accounts for.
`volume24hUSD`	float64	`Gt`, `Gte`, `Lt`, `Lte`	default	Traded volume over the trailing 24 hours, in USD.
`tradeCount24h`	int64		yes	Number of trades over the trailing 24 hours.

Example

curl

curl "https://api.blockworks.com/query/timeseries/bqen/1d/100-140-110?timeframe=7d&selections=close-price,volume" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get Market timeseries for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts

Token Unlocks

Endpoints

List Markets

Get Market

Batch Get Market timeseries

Get Market timeseries

Metrics

Columns

Example

​Endpoints

List Markets

Get Market

Batch Get Market timeseries

Get Market timeseries

​Metrics

​Columns

​Example

Endpoints

Metrics

Columns

Example