GMX Markets API
The Markets API from GMX — 5 operation(s) for markets.
The Markets API from GMX — 5 operation(s) for markets.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/gmx:gmx-markets-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: '@gmx-io/gmx-public-api Markets API'
version: 1.0.0
license:
name: Copyright
contact: {}
servers:
- url: /v1
tags:
- name: Markets
paths:
/markets:
get:
operationId: GetMarkets
responses:
'200':
description: Success
content:
application/json:
schema:
items:
$ref: '#/components/schemas/MarketWithTiersResponse'
type: array
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters: []
summary: Get markets
x-summary-source: derived
/markets/tickers:
get:
operationId: GetMarketsTickers
responses:
'200':
description: Success
content:
application/json:
schema:
items:
$ref: '#/components/schemas/MarketTickerResponse'
type: array
'400':
description: Bad Request - Invalid market addresses or symbols
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters:
- in: query
name: addresses
required: false
schema:
type: array
items:
type: string
- in: query
name: symbols
required: false
schema:
type: array
items:
type: string
summary: Get markets tickers
x-summary-source: derived
/markets/trading-capacity:
get:
operationId: GetTradingCapacity
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/TradingCapacityResponse'
'400':
description: Bad Request - Invalid market symbol or direction
'404':
description: Market not found
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters:
- in: query
name: symbol
required: true
schema:
type: string
- in: query
name: direction
required: true
schema:
type: string
enum:
- long
- short
summary: Get trading capacity
x-summary-source: derived
/markets/info:
get:
operationId: GetMarketsInfo
responses:
'200':
description: Success
content:
application/json:
schema:
items:
$ref: '#/components/schemas/MarketInfoResponse'
type: array
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters: []
summary: Get markets info
x-summary-source: derived
/markets/config:
get:
operationId: GetMarketsConfig
responses:
'200':
description: Success
content:
application/json:
schema:
items:
$ref: '#/components/schemas/MarketConfigResponse'
type: array
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters: []
summary: Get markets config
x-summary-source: derived
/markets/values:
get:
operationId: GetMarketsValues
responses:
'200':
description: Success
content:
application/json:
schema:
items:
$ref: '#/components/schemas/MarketValuesResponse'
type: array
'500':
description: Internal Server Error
tags:
- Markets
security: []
parameters: []
summary: Get markets values
x-summary-source: derived
components:
schemas:
MarketInfoResponse:
properties:
borrowingFactorPerSecondForShorts:
type: string
borrowingFactorPerSecondForLongs:
type: string
fundingFactorPerSecond:
type: string
totalBorrowingFees:
type: string
virtualInventoryForPositionsInTokens:
type: string
virtualInventoryForPositions:
type: string
virtualPoolAmountForShortToken:
type: string
virtualPoolAmountForLongToken:
type: string
longsPayShorts:
type: boolean
shortInterestInTokensUsingShortToken:
type: string
shortInterestInTokensUsingLongToken:
type: string
longInterestInTokensUsingShortToken:
type: string
longInterestInTokensUsingLongToken:
type: string
shortInterestUsdUsingShortToken:
type: string
shortInterestUsdUsingLongToken:
type: string
longInterestUsdUsingShortToken:
type: string
longInterestUsdUsingLongToken:
type: string
shortInterestInTokens:
type: string
longInterestInTokens:
type: string
shortInterestUsd:
type: string
longInterestUsd:
type: string
positionImpactPoolAmount:
type: string
poolValueMin:
type: string
poolValueMax:
type: string
shortPoolAmount:
type: string
longPoolAmount:
type: string
virtualShortTokenId:
type: string
virtualLongTokenId:
type: string
virtualIndexTokenId:
type: string
virtualMarketId:
type: string
maxShortPoolUsdForDeposit:
type: string
maxLongPoolUsdForDeposit:
type: string
maxShortPoolAmount:
type: string
maxLongPoolAmount:
type: string
withdrawalFeeFactorBalanceWasNotImproved:
type: string
withdrawalFeeFactorBalanceWasImproved:
type: string
swapImpactExponentFactor:
type: string
swapImpactFactorNegative:
type: string
swapImpactFactorPositive:
type: string
atomicSwapFeeFactor:
type: string
swapFeeFactorForBalanceWasNotImproved:
type: string
swapFeeFactorForBalanceWasImproved:
type: string
useOpenInterestInTokensForBalance:
type: boolean
positionImpactExponentFactorNegative:
type: string
positionImpactExponentFactorPositive:
type: string
lentPositionImpactPoolAmount:
type: string
maxLendableImpactUsd:
type: string
maxLendableImpactFactorForWithdrawals:
type: string
maxLendableImpactFactor:
type: string
maxFundingFactorPerSecondShort:
type: string
maxFundingFactorPerSecondLong:
type: string
minFundingFactorPerSecondShort:
type: string
minFundingFactorPerSecondLong:
type: string
thresholdForDecreaseFunding:
type: string
thresholdForStableFunding:
type: string
fundingDecreaseFactorPerSecond:
type: string
minFundingIncreaseRatePerSecond:
type: string
fundingIncreaseFactorPerSecond:
type: string
fundingExponentFactor:
type: string
fundingFactor:
type: string
borrowingExponentFactorShort:
type: string
borrowingExponentFactorLong:
type: string
borrowingFactorShort:
type: string
borrowingFactorLong:
type: string
maxPositionImpactFactorForLiquidations:
type: string
maxPositionImpactFactorNegative:
type: string
maxPositionImpactFactorPositive:
type: string
positionImpactFactorNegative:
type: string
positionImpactFactorPositive:
type: string
positionFeeFactorForBalanceWasNotImproved:
type: string
positionFeeFactorForBalanceWasImproved:
type: string
maxPnlFactorForWithdrawalsShort:
type: string
maxPnlFactorForWithdrawalsLong:
type: string
maxPnlFactorForDepositsShort:
type: string
maxPnlFactorForDepositsLong:
type: string
maxPnlFactorForTradersShort:
type: string
maxPnlFactorForTradersLong:
type: string
minCollateralFactorForOpenInterestShort:
type: string
minCollateralFactorForOpenInterestLong:
type: string
minCollateralFactorForLiquidation:
type: string
minCollateralFactor:
type: string
swapImpactPoolAmountShort:
type: string
swapImpactPoolAmountLong:
type: string
positionImpactPoolDistributionRate:
type: string
minPositionImpactPoolAmount:
type: string
maxCollateralSumShortTokenShort:
type: string
maxCollateralSumShortTokenLong:
type: string
maxCollateralSumLongTokenShort:
type: string
maxCollateralSumLongTokenLong:
type: string
maxOpenInterestShort:
type: string
maxOpenInterestLong:
type: string
openInterestReserveFactorShort:
type: string
openInterestReserveFactorLong:
type: string
reserveFactorShort:
type: string
reserveFactorLong:
type: string
data:
type: string
isDisabled:
type: boolean
isSpotOnly:
type: boolean
isSameCollaterals:
type: boolean
shortTokenAddress:
type: string
longTokenAddress:
type: string
indexTokenAddress:
type: string
marketTokenAddress:
type: string
name:
type: string
required:
- borrowingFactorPerSecondForShorts
- borrowingFactorPerSecondForLongs
- fundingFactorPerSecond
- totalBorrowingFees
- virtualInventoryForPositionsInTokens
- virtualInventoryForPositions
- virtualPoolAmountForShortToken
- virtualPoolAmountForLongToken
- longsPayShorts
- shortInterestInTokens
- longInterestInTokens
- shortInterestUsd
- longInterestUsd
- positionImpactPoolAmount
- poolValueMin
- poolValueMax
- shortPoolAmount
- longPoolAmount
- virtualShortTokenId
- virtualLongTokenId
- virtualIndexTokenId
- virtualMarketId
- maxShortPoolUsdForDeposit
- maxLongPoolUsdForDeposit
- maxShortPoolAmount
- maxLongPoolAmount
- swapImpactExponentFactor
- swapImpactFactorNegative
- swapImpactFactorPositive
- atomicSwapFeeFactor
- swapFeeFactorForBalanceWasNotImproved
- swapFeeFactorForBalanceWasImproved
- useOpenInterestInTokensForBalance
- positionImpactExponentFactorNegative
- positionImpactExponentFactorPositive
- lentPositionImpactPoolAmount
- maxLendableImpactUsd
- maxLendableImpactFactorForWithdrawals
- maxLendableImpactFactor
- maxFundingFactorPerSecondShort
- maxFundingFactorPerSecondLong
- minFundingFactorPerSecondShort
- minFundingFactorPerSecondLong
- thresholdForDecreaseFunding
- thresholdForStableFunding
- fundingDecreaseFactorPerSecond
- minFundingIncreaseRatePerSecond
- fundingIncreaseFactorPerSecond
- fundingExponentFactor
- fundingFactor
- borrowingExponentFactorShort
- borrowingExponentFactorLong
- borrowingFactorShort
- borrowingFactorLong
- maxPositionImpactFactorForLiquidations
- maxPositionImpactFactorNegative
- maxPositionImpactFactorPositive
- positionImpactFactorNegative
- positionImpactFactorPositive
- positionFeeFactorForBalanceWasNotImproved
- positionFeeFactorForBalanceWasImproved
- maxPnlFactorForTradersShort
- maxPnlFactorForTradersLong
- minCollateralFactorForOpenInterestShort
- minCollateralFactorForOpenInterestLong
- minCollateralFactorForLiquidation
- minCollateralFactor
- swapImpactPoolAmountShort
- swapImpactPoolAmountLong
- positionImpactPoolDistributionRate
- minPositionImpactPoolAmount
- maxCollateralSumShortTokenShort
- maxCollateralSumShortTokenLong
- maxCollateralSumLongTokenShort
- maxCollateralSumLongTokenLong
- maxOpenInterestShort
- maxOpenInterestLong
- openInterestReserveFactorShort
- openInterestReserveFactorLong
- reserveFactorShort
- reserveFactorLong
- data
- isDisabled
- isSpotOnly
- isSameCollaterals
- shortTokenAddress
- longTokenAddress
- indexTokenAddress
- marketTokenAddress
- name
type: object
LeverageTierResponse:
properties:
maxPositionSize:
type: string
minCollateralFactor:
type: string
maxLeverage:
type: string
required:
- minCollateralFactor
- maxLeverage
type: object
TradingCapacityResponse:
properties:
marketDataStatus:
$ref: '#/components/schemas/MarketDataStatus'
jitDataStatus:
$ref: '#/components/schemas/JitDataStatus'
limitingFactor:
$ref: '#/components/schemas/TradingCapacityLimitingFactor'
jitAvailableLiquidity:
type: string
baseAvailableLiquidity:
type: string
availableLiquidity:
type: string
required:
- marketDataStatus
- jitDataStatus
- limitingFactor
- jitAvailableLiquidity
- baseAvailableLiquidity
- availableLiquidity
type: object
MarketValuesResponse:
allOf:
- $ref: '#/components/schemas/Pick_MarketInfoResponse.MarketValuesFieldKey_'
- properties:
updatedAt:
type:
- number
- 'null'
format: double
required:
- updatedAt
type: object
Pick_MarketInfoResponse.Exclude_keyofMarketInfoResponse.Exclude_MarketValuesFieldKey.marketTokenAddress___:
properties:
marketTokenAddress:
type: string
indexTokenAddress:
type: string
longTokenAddress:
type: string
shortTokenAddress:
type: string
isSameCollaterals:
type: boolean
isSpotOnly:
type: boolean
name:
type: string
data:
type: string
isDisabled:
type: boolean
maxLongPoolAmount:
type: string
maxShortPoolAmount:
type: string
maxLongPoolUsdForDeposit:
type: string
maxShortPoolUsdForDeposit:
type: string
reserveFactorLong:
type: string
reserveFactorShort:
type: string
openInterestReserveFactorLong:
type: string
openInterestReserveFactorShort:
type: string
maxOpenInterestLong:
type: string
maxOpenInterestShort:
type: string
maxCollateralSumLongTokenLong:
type: string
maxCollateralSumLongTokenShort:
type: string
maxCollateralSumShortTokenLong:
type: string
maxCollateralSumShortTokenShort:
type: string
borrowingFactorLong:
type: string
borrowingFactorShort:
type: string
borrowingExponentFactorLong:
type: string
borrowingExponentFactorShort:
type: string
fundingFactor:
type: string
fundingExponentFactor:
type: string
fundingIncreaseFactorPerSecond:
type: string
minFundingIncreaseRatePerSecond:
type: string
fundingDecreaseFactorPerSecond:
type: string
thresholdForStableFunding:
type: string
thresholdForDecreaseFunding:
type: string
minFundingFactorPerSecondLong:
type: string
minFundingFactorPerSecondShort:
type: string
maxFundingFactorPerSecondLong:
type: string
maxFundingFactorPerSecondShort:
type: string
minPositionImpactPoolAmount:
type: string
positionImpactPoolDistributionRate:
type: string
minCollateralFactor:
type: string
minCollateralFactorForLiquidation:
type: string
minCollateralFactorForOpenInterestLong:
type: string
minCollateralFactorForOpenInterestShort:
type: string
maxPnlFactorForTradersLong:
type: string
maxPnlFactorForTradersShort:
type: string
maxPnlFactorForDepositsLong:
type: string
maxPnlFactorForDepositsShort:
type: string
maxPnlFactorForWithdrawalsLong:
type: string
maxPnlFactorForWithdrawalsShort:
type: string
positionFeeFactorForBalanceWasImproved:
type: string
positionFeeFactorForBalanceWasNotImproved:
type: string
positionImpactFactorPositive:
type: string
positionImpactFactorNegative:
type: string
maxPositionImpactFactorPositive:
type: string
maxPositionImpactFactorNegative:
type: string
maxPositionImpactFactorForLiquidations:
type: string
maxLendableImpactFactor:
type: string
maxLendableImpactFactorForWithdrawals:
type: string
maxLendableImpactUsd:
type: string
lentPositionImpactPoolAmount:
type: string
positionImpactExponentFactorPositive:
type: string
positionImpactExponentFactorNegative:
type: string
useOpenInterestInTokensForBalance:
type: boolean
swapFeeFactorForBalanceWasImproved:
type: string
swapFeeFactorForBalanceWasNotImproved:
type: string
atomicSwapFeeFactor:
type: string
swapImpactFactorPositive:
type: string
swapImpactFactorNegative:
type: string
swapImpactExponentFactor:
type: string
withdrawalFeeFactorBalanceWasImproved:
type: string
withdrawalFeeFactorBalanceWasNotImproved:
type: string
virtualMarketId:
type: string
virtualIndexTokenId:
type: string
virtualLongTokenId:
type: string
virtualShortTokenId:
type: string
required:
- marketTokenAddress
- indexTokenAddress
- longTokenAddress
- shortTokenAddress
- isSameCollaterals
- isSpotOnly
- name
- data
- isDisabled
- maxLongPoolAmount
- maxShortPoolAmount
- maxLongPoolUsdForDeposit
- maxShortPoolUsdForDeposit
- reserveFactorLong
- reserveFactorShort
- openInterestReserveFactorLong
- openInterestReserveFactorShort
- maxOpenInterestLong
- maxOpenInterestShort
- maxCollateralSumLongTokenLong
- maxCollateralSumLongTokenShort
- maxCollateralSumShortTokenLong
- maxCollateralSumShortTokenShort
- borrowingFactorLong
- borrowingFactorShort
- borrowingExponentFactorLong
- borrowingExponentFactorShort
- fundingFactor
- fundingExponentFactor
- fundingIncreaseFactorPerSecond
- minFundingIncreaseRatePerSecond
- fundingDecreaseFactorPerSecond
- thresholdForStableFunding
- thresholdForDecreaseFunding
- minFundingFactorPerSecondLong
- minFundingFactorPerSecondShort
- maxFundingFactorPerSecondLong
- maxFundingFactorPerSecondShort
- minPositionImpactPoolAmount
- positionImpactPoolDistributionRate
- minCollateralFactor
- minCollateralFactorForLiquidation
- minCollateralFactorForOpenInterestLong
- minCollateralFactorForOpenInterestShort
- maxPnlFactorForTradersLong
- maxPnlFactorForTradersShort
- positionFeeFactorForBalanceWasImproved
- positionFeeFactorForBalanceWasNotImproved
- positionImpactFactorPositive
- positionImpactFactorNegative
- maxPositionImpactFactorPositive
- maxPositionImpactFactorNegative
- maxPositionImpactFactorForLiquidations
- maxLendableImpactFactor
- maxLendableImpactFactorForWithdrawals
- maxLendableImpactUsd
- lentPositionImpactPoolAmount
- positionImpactExponentFactorPositive
- positionImpactExponentFactorNegative
- useOpenInterestInTokensForBalance
- swapFeeFactorForBalanceWasImproved
- swapFeeFactorForBalanceWasNotImproved
- atomicSwapFeeFactor
- swapImpactFactorPositive
- swapImpactFactorNegative
- swapImpactExponentFactor
- virtualMarketId
- virtualIndexTokenId
- virtualLongTokenId
- virtualShortTokenId
type: object
description: From T, pick a set of properties whose keys are in the union K
MarketDataStatus:
type: string
enum:
- fresh
- stale
JitDataStatus:
type: string
enum:
- available
- stale
- unavailable
MarketTickerResponse:
properties:
capacityShort:
$ref: '#/components/schemas/TradingCapacityResponse'
capacityLong:
$ref: '#/components/schemas/TradingCapacityResponse'
netRateShort:
type: string
netRateLong:
type: string
borrowingRateShort:
type: string
borrowingRateLong:
type: string
fundingRateShort:
type: string
fundingRateLong:
type: string
poolAmountShortUsd:
type: string
poolAmountLongUsd:
type: string
availableLiquidityShort:
type: string
availableLiquidityLong:
type: string
shortInterestUsdMark:
type: string
longInterestUsdMark:
type: string
shortInterestUsd:
type: string
longInterestUsd:
type: string
shortInterestInTokens:
type: string
longInterestInTokens:
type: string
priceChangePercent24hBps:
type: string
priceChange24h:
type: string
close24h:
type: string
open24h:
type: string
low24h:
type: string
high24h:
type: string
markPrice:
type: string
maxPrice:
type: string
minPrice:
type: string
marketTokenAddress:
type: string
symbol:
type: string
required:
- capacityShort
- capacityLong
- netRateShort
- netRateLong
- borrowingRateShort
- borrowingRateLong
- fundingRateShort
- fundingRateLong
- poolAmountShortUsd
- poolAmountLongUsd
- availableLiquidityShort
- availableLiquidityLong
- shortInterestUsdMark
- longInterestUsdMark
- shortInterestUsd
- longInterestUsd
- shortInterestInTokens
- longInterestInTokens
- priceChangePercent24hBps
- priceChange24h
- close24h
- open24h
- low24h
- high24h
- markPrice
- maxPrice
- minPrice
- marketTokenAddress
- symbol
type: object
Omit_MarketInfoResponse.Exclude_MarketValuesFieldKey.marketTokenAddress__:
$ref: '#/components/schemas/Pick_MarketInfoResponse.Exclude_keyofMarketInfoResponse.Exclude_MarketValuesFieldKey.marketTokenAddress___'
description: Construct a type with the properties of T except for those in type K.
MarketConfigResponse:
$ref: '#/components/schemas/Omit_MarketInfoResponse.Exclude_MarketValuesFieldKey.marketTokenAddress__'
Pick_MarketInfoResponse.MarketValuesFieldKey_:
properties:
marketTokenAddress:
type: string
longPoolAmount:
type: string
shortPoolAmount:
type: string
poolValueMax:
type: string
poolValueMin:
type: string
totalBorrowingFees:
type: string
positionImpactPoolAmount:
type: string
swapImpactPoolAmountLong:
type: string
swapImpactPoolAmountShort:
type: string
longInterestUsd:
type: string
shortInterestUsd:
type: string
longInterestInTokens:
type: string
shortInterestInTokens:
type: string
longInterestUsdUsingLongToken:
type: string
longInterestUsdUsingShortToken:
type: string
shortInterestUsdUsingLongToken:
type: string
shortInterestUsdUsingShortToken:
type: string
longInterestInTokensUsingLongToken:
type: string
longInterestInTokensUsingShortToken:
type: string
shortInterestInTokensUsingLongToken:
type: string
shortInterestInTokensUsingShortToken:
type: string
borrowingFactorPerSecondForLongs:
type: string
borrowingFactorPerSecondForShorts:
type: string
fundingFactorPerSecond:
type: string
longsPayShorts:
type: boolean
virtualPoolAmountForLongToken:
type: string
virtualPoolAmountForShortToken:
type: string
virtualInventoryForPositions:
type: string
virtualInventoryForPositionsInTokens:
type: string
required:
- marketTokenAddress
- longPoolAmount
- shortPoolAmount
- poolValueMax
- poolValueMin
- totalBorrowingFees
- positionImpactPoolAmount
- swapImpactPoolAmountLong
- swapImpactPoolAmountShort
- longInterestUsd
- shortInterestUsd
- longInterestInTokens
- shortInterestInTokens
- borrowingFactorPerSecondForLongs
- borrowingFactorPerSecondForShorts
- fundingFactorPerSecond
- longsPayShorts
- virtualPoolAmountForLongToken
- virtualPoolAmountForShortToken
- virtualInventoryForPositions
- virtualInventoryForPositionsInTokens
type: object
description: From T, pick a set of properties whose keys are in the union K
TradingCapacityLimitingFactor:
type: string
enum:
- reserve
- openInterest
- both
- notApplicable
MarketWithTiersResponse:
properties:
minCollateralUsd:
type: string
minPositionSizeUsd:
type: string
leverageTiers:
items:
$ref: '#/components/schemas/LeverageTierResponse'
type: array
isSpotOnly:
type: boolean
listingDate:
type: number
format: double
isListed:
type: boolean
shortTokenAddress:
type: string
longTokenAddress:
type: string
indexTokenAddress:
type: string
marketTokenAddress:
type: string
symbol:
type: string
required:
- minCollateralUsd
- minPositionSizeUsd
- leverageTiers
- isSpotOnly
- isListed
- shortTokenAddress
- longTokenAddress
- indexTokenAddress
- marketTokenAddress
- symbol
type: object
x-provenance:
method: harvested
publisher: GMX
source: https://arbitrum.gmxapi.io/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)