latestOpenAPI 3.0.02026-08-10111234.7 KB

742e86bc3ab0

markets

Returns market data for listed markets, optionally filterable by asset address, name, symbol, underlying address, underlying name or underlying symbol.

Versioning (controlled via accept-version header):

  • stable (default): chainId is required. Response includes a top-level tokens array of TokenMetadata objects. Markets include rewardsDistributors and pointsDistributions.
  • next: chainId is optional for cross-chain queries. Token metadata is embedded inside each market as underlyingTokenMetadata with nested tokenPrices. Supports accountAddress for Prime APY data. No top-level tokens field.
get/markets

Query parameters

chainIdstring

[stable] Required. [next] Optional. Blockchain chain ID to filter results.

addressstring

[both] Filter by vToken address.

symbolstring

[both] Filter by asset symbol.

namestring

[both] Filter by asset name.

underlyingAddressstring

[both] Filter by underlying token address.

underlyingNamestring

[both] Filter by underlying token name.

underlyingSymbolstring

[both] Filter by underlying token symbol.

orderstring

[both] Columns to sort by. Default is descending. Prepend + for ascending (e.g. +underlyingName).

limitinteger

[both] Maximum number of results to return.

pageinteger

[both] Page number for pagination.

accountAddressstring

[next only] Account address to embed personalised Prime APY boosts into each market.

Headers

accept-version'stable' | 'next'

Selects the API version. stable (default) requires chainId and returns a top-level tokens array. next supports cross-chain queries and embeds token data inside each market as underlyingTokenMetadata.

Response

Returns Market data for all listed markets.

OR