Liquidity
Oracle API endpoints for APY, performance, and GLV information.
Use this page for public liquidity and yield reads. For a broader comparison with SDK and GraphQL surfaces, start with the API integration guide.
Fee APYs
To retrieve fee APYs for GM pools and GLV vaults:
| Network | URL |
|---|---|
| Arbitrum | https://arbitrum-api.gmxinfra.io/apy?period=total |
| Avalanche | https://avalanche-api.gmxinfra.io/apy?period=total |
| Botanix | https://botanix-api.gmxinfra.io/apy?period=total |
Accepted query parameters:
period:1d,7d,30d,90d,180d,1y,total. Defaults to7d.
Performance
To retrieve annualized performance for GM pools and GLV vaults:
| Network | URL |
|---|---|
| Arbitrum | https://arbitrum-api.gmxinfra.io/performance/annualized?period=total |
| Avalanche | https://avalanche-api.gmxinfra.io/performance/annualized?period=total |
| Botanix | https://botanix-api.gmxinfra.io/performance/annualized?period=total |
Accepted query parameters:
period:7d,30d,90d,180d,1y,total. Defaults to90d. The1dperiod is not supported and returns a 400 error.address: Address of a specific GM pool or GLV vault to retrieve data for only that entity.
GLV tokens
To retrieve a list of GMX Liquidity Vault (GLV) tokens:
| Network | URL |
|---|---|
| Arbitrum | https://arbitrum-api.gmxinfra.io/glvs/ |
| Avalanche | https://avalanche-api.gmxinfra.io/glvs/ |
| Botanix | https://botanix-api.gmxinfra.io/glvs/ |
GLV info
To retrieve extended information for GLV vaults, including market exposure, GM pool balances in USD, isDisabled status, and listing date:
| Network | URL |
|---|---|
| Arbitrum | https://arbitrum-api.gmxinfra.io/glvs/info |
| Avalanche | https://avalanche-api.gmxinfra.io/glvs/info |
| Botanix | https://botanix-api.gmxinfra.io/glvs/info |
/glvs/info is a GLV composition endpoint: it returns vault metadata, market exposure, GM balances, and GM balance values, but not a glvPrice field. The Oracle API exposes current off-chain GLV ticker prices separately through /prices/tickers; use /tokens to get the exact GLV symbol. Use Chainlink Data Feeds where available for external on-chain integrations, or call GlvReader.getGlvTokenPrice for direct GMX valuation. See Getting GM and GLV token prices.
Operational notes
/apycurrently caches responses for1800seconds and returns400for an invalidperiod./performance/annualizedand/performance/snapshotscurrently cache by day and return400for unsupported periods such as1d.- Use these routes for yield and performance reporting, not for near-live position or order state.
- If you need write-path status after a transaction, use SDK v1 or direct contracts and then poll the relevant read surface.