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.
| Network | Availability | URL |
|---|---|---|
| Arbitrum | ✅ Active trading | https://arbitrum-api.gmxinfra.io/markets |
| Avalanche | ✅ Active trading | https://avalanche-api.gmxinfra.io/markets |
| Botanix | ⚠️ Legacy reads; withdrawals only | https://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:
| Network | Availability | URL |
|---|---|---|
| Arbitrum | ✅ Active trading | https://arbitrum-api.gmxinfra.io/markets/info |
| Avalanche | ✅ Active trading | https://avalanche-api.gmxinfra.io/markets/info |
| Botanix | ⚠️ Legacy reads; withdrawals only | https://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.
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
/marketsfor a market catalog or configuration view. The current implementation caches this route for10seconds. - Use
/markets/infofor near-live liquidity, open interest, funding, borrowing, token amounts, and theisListedflag. The current implementation caches this route for10seconds. - Use
/markets/statewhen you only need market status values such as open, closed, or unknown state,closingPrice, andlatestMarketStatusTransitionTimestamp. The current implementation caches this route for5seconds. - Use
/markets/tickerswhen you need filtered ticker reads. Invalidaddressesorsymbolsquery values return400. - 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.