Skip to main content

Markets

Oracle API endpoints for trading market information.

Use this page when you need public market reads from the Oracle API. For exact “which surface should I use” guidance, start with the API integration guide.

Trading markets and GM tokens

To retrieve a market list and its associated tokens, use the endpoint for the relevant network. Arbitrum and Avalanche return active trading markets. The Botanix endpoint remains available only as a legacy read surface.

NetworkAvailabilityURL
Arbitrum✅ Active tradinghttps://arbitrum-api.gmxinfra.io/markets
Avalanche✅ Active tradinghttps://avalanche-api.gmxinfra.io/markets
Botanix⚠️ Legacy reads; withdrawals onlyhttps://botanix-api.gmxinfra.io/markets

This endpoint caches responses for 10 seconds.

Trading markets and GM info

To retrieve detailed information about markets and their tokens — including liquidity, open interest, token amounts, funding, borrowing, net rates, the isListed flag, and listing date — use the corresponding endpoint:

NetworkAvailabilityURL
Arbitrum✅ Active tradinghttps://arbitrum-api.gmxinfra.io/markets/info
Avalanche✅ Active tradinghttps://avalanche-api.gmxinfra.io/markets/info
Botanix⚠️ Legacy reads; withdrawals onlyhttps://botanix-api.gmxinfra.io/markets/info

The /markets/info endpoint caches responses for 10 seconds. Treat it as a near-live snapshot, not as same-block state.

The Botanix responses can still contain markets with isListed: true. That flag describes the retained market catalog; it does not mean new Botanix trades are supported. Use the data only for legacy positions and withdrawal workflows.

GM token prices

Oracle API /markets/info exposes GM market state such as liquidity, open interest, token amounts, rates, listing date, and the GM market token address. It does not expose GM token prices as first-class fields, and GM market tokens are not exposed as GM [...] tickers in /prices/tickers. Use Chainlink Data Feeds where available, or call Reader.getMarketTokenPrice for direct GMX valuation. See Getting GM and GLV token prices.

Operational notes

  • Use /markets for a market catalog or configuration view. The current implementation caches this route for 10 seconds.
  • Use /markets/info for near-live liquidity, open interest, funding, borrowing, token amounts, and the isListed flag. The current implementation caches this route for 10 seconds.
  • Use /markets/state when you only need market status values such as open, closed, or unknown state, closingPrice, and latestMarketStatusTransitionTimestamp. The current implementation caches this route for 5 seconds.
  • Use /markets/tickers when you need filtered ticker reads. Invalid addresses or symbols query values return 400.
  • If you need fallback behavior, use the alternate public URLs documented on Fallback URLs.

Funding rate data freshness

The /rates endpoint returns hourly snapshots produced by the Squid indexer — it is not realtime data. Each snapshot is timestamped at the start of the hour. Funding values are replayed from indexed market state, including MarketInfo, savedFundingFactorPerSecond, fundingUpdatedAt, open interest, and relevant DataStore settings. Use /rates for historical rate analysis, averages, and trend charts.

For near-live funding rates, use /markets/info instead. It includes current funding and borrowing rates alongside liquidity and open interest.