The Perpetual Futures (USDT-M) API from BingX — 53 operation(s) for perpetual futures (usdt-m).
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/bingx:bingx-perpetual-futures-usdt-m-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: BingX Perpetual Futures (USDT-M) API
version: docs-v3
description: AE-AUTHORED, GENERATED FROM DOCUMENTATION. BingX does not publish an OpenAPI document. This contract was generated by API Evangelist from the endpoint definitions embedded in the official BingX API Docs (https://bingx-api.github.io/docs-v3/). It records each documented path, method, summary and rate limit only; request parameters and response schemas are not modelled. Not an official BingX artifact.
x-generated-from: documentation
x-ae-authored: true
x-source: https://bingx-api.github.io/docs-v3/
x-generated: '2026-10-13'
servers:
- url: https://open-api.bingx.com
security:
- ApiKey: []
tags:
- name: Perpetual Futures (USDT-M)
paths:
/openApi/swap/v1/maintMarginRatio:
get:
operationId: get-openApi-swap-v1-maintMarginRatio
summary: Position and Maintenance Margin Ratio
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/market/historicalTrades:
get:
operationId: get-openApi-swap-v1-market-historicalTrades
summary: Query historical transaction orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v1/market/markPriceKlines:
get:
operationId: get-openApi-swap-v1-market-markPriceKlines
summary: Mark Price Kline/Candlestick Data
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v1/positionMargin/history:
get:
operationId: get-openApi-swap-v1-positionMargin-history
summary: Isolated Margin Change History
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/positionSide/dual:
get:
operationId: get-openApi-swap-v1-positionSide-dual
summary: Query position mode
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
post:
operationId: post-openApi-swap-v1-positionSide-dual
summary: Set Position Mode
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 4/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/ticker/price:
get:
operationId: get-openApi-swap-v1-ticker-price
summary: Symbol Price Ticker
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v1/trade/amend:
post:
operationId: post-openApi-swap-v1-trade-amend
summary: Modify Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
/openApi/swap/v1/trade/assetMode:
post:
operationId: post-openApi-swap-v1-trade-assetMode
summary: Switch Multi-Assets Mode
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
get:
operationId: get-openApi-swap-v1-trade-assetMode
summary: Query Multi-Assets Mode
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/autoAddMargin:
post:
operationId: post-openApi-swap-v1-trade-autoAddMargin
summary: Hedge mode Position - Automatic Margin Addition
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/batchCancelReplace:
post:
operationId: post-openApi-swap-v1-trade-batchCancelReplace
summary: Cancel orders in batches and place orders in batches
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/cancelReplace:
post:
operationId: post-openApi-swap-v1-trade-cancelReplace
summary: Cancel an Existing Order and Send a New Orde
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/closePosition:
post:
operationId: post-openApi-swap-v1-trade-closePosition
summary: Close position by position ID
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/fullOrder:
get:
operationId: get-openApi-swap-v1-trade-fullOrder
summary: All Orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/multiAssetsRules:
get:
operationId: get-openApi-swap-v1-trade-multiAssetsRules
summary: Query Multi-Assets Rules
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/trade/reverse:
post:
operationId: post-openApi-swap-v1-trade-reverse
summary: One-Click Reverse Position
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/tradingRules:
get:
operationId: get-openApi-swap-v1-tradingRules
summary: Trading Rules
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
/openApi/swap/v1/twap/cancelOrder:
post:
operationId: post-openApi-swap-v1-twap-cancelOrder
summary: Cancel TWAP Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/twap/historyOrders:
get:
operationId: get-openApi-swap-v1-twap-historyOrders
summary: Query TWAP Historical Orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/twap/openOrders:
get:
operationId: get-openApi-swap-v1-twap-openOrders
summary: Query TWAP Entrusted Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/twap/order:
post:
operationId: post-openApi-swap-v1-twap-order
summary: Place TWAP Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/twap/orderDetail:
get:
operationId: get-openApi-swap-v1-twap-orderDetail
summary: TWAP Order Details
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v1/user/marginAssets:
get:
operationId: get-openApi-swap-v1-user-marginAssets
summary: Query Multi-Assets Margin
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/quote/bookTicker:
get:
operationId: get-openApi-swap-v2-quote-bookTicker
summary: Symbol Order Book Ticker
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/contracts:
get:
operationId: get-openApi-swap-v2-quote-contracts
summary: USDT-M Perp Futures symbols
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
/openApi/swap/v2/quote/depth:
get:
operationId: get-openApi-swap-v2-quote-depth
summary: Order Book
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/fundingRate:
get:
operationId: get-openApi-swap-v2-quote-fundingRate
summary: Get Funding Rate History
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/openInterest:
get:
operationId: get-openApi-swap-v2-quote-openInterest
summary: Open Interest Statistics
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/premiumIndex:
get:
operationId: get-openApi-swap-v2-quote-premiumIndex
summary: Mark Price and Funding Rate
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/ticker:
get:
operationId: get-openApi-swap-v2-quote-ticker
summary: 24hr Ticker Price Change Statistics
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/quote/trades:
get:
operationId: get-openApi-swap-v2-quote-trades
summary: Recent Trades List
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v2/trade/allFillOrders:
get:
operationId: get-openApi-swap-v2-trade-allFillOrders
summary: Query historical transaction orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/allOpenOrders:
delete:
operationId: delete-openApi-swap-v2-trade-allOpenOrders
summary: Cancel All Open Orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/allOrders:
get:
operationId: get-openApi-swap-v2-trade-allOrders
summary: Query Order history
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '3'
/openApi/swap/v2/trade/batchOrders:
delete:
operationId: delete-openApi-swap-v2-trade-batchOrders
summary: Cancel multiple orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '3'
post:
operationId: post-openApi-swap-v2-trade-batchOrders
summary: Place multiple orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '3'
/openApi/swap/v2/trade/cancelAllAfter:
post:
operationId: post-openApi-swap-v2-trade-cancelAllAfter
summary: Cancel All After
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 1/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/closeAllPositions:
post:
operationId: post-openApi-swap-v2-trade-closeAllPositions
summary: Close All Positions
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/fillHistory:
get:
operationId: get-openApi-swap-v2-trade-fillHistory
summary: Query historical transaction details
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/forceOrders:
get:
operationId: get-openApi-swap-v2-trade-forceOrders
summary: User's Force Orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 10/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/getVst:
post:
operationId: post-openApi-swap-v2-trade-getVst
summary: Apply VST
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/leverage:
post:
operationId: post-openApi-swap-v2-trade-leverage
summary: Set Leverage
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
get:
operationId: get-openApi-swap-v2-trade-leverage
summary: Query Leverage and Available Positions
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/marginType:
post:
operationId: post-openApi-swap-v2-trade-marginType
summary: Change Margin Type
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
get:
operationId: get-openApi-swap-v2-trade-marginType
summary: Query Margin Type
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/openOrder:
get:
operationId: get-openApi-swap-v2-trade-openOrder
summary: Query pending order status
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/openOrders:
get:
operationId: get-openApi-swap-v2-trade-openOrders
summary: Current All Open Orders
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '3'
/openApi/swap/v2/trade/order:
post:
operationId: post-openApi-swap-v2-trade-order
summary: Place order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 10/second
x-ip-rate-limit-weight: '3'
get:
operationId: get-openApi-swap-v2-trade-order
summary: Query Order details
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 30/second
x-ip-rate-limit-weight: '2'
delete:
operationId: delete-openApi-swap-v2-trade-order
summary: Cancel Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 10/second
x-ip-rate-limit-weight: '3'
/openApi/swap/v2/trade/order/test:
post:
operationId: post-openApi-swap-v2-trade-order-test
summary: Test Order
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/positionHistory:
get:
operationId: get-openApi-swap-v2-trade-positionHistory
summary: Query Position History
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/trade/positionMargin:
post:
operationId: post-openApi-swap-v2-trade-positionMargin
summary: Modify Isolated Position Margin
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 2/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/user/commissionRate:
get:
operationId: get-openApi-swap-v2-user-commissionRate
summary: Query Trading Commission Rate
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/user/income:
get:
operationId: get-openApi-swap-v2-user-income
summary: Get Account Profit and Loss Fund Flow
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/user/income/export:
get:
operationId: get-openApi-swap-v2-user-income-export
summary: Export fund flow
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '2'
/openApi/swap/v2/user/positions:
get:
operationId: get-openApi-swap-v2-user-positions
summary: Query position data
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 10/second
x-ip-rate-limit-weight: '3'
/openApi/swap/v3/quote/klines:
get:
operationId: get-openApi-swap-v3-quote-klines
summary: Kline/Candlestick Data
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-ip-rate-limit-weight: '1'
/openApi/swap/v3/user/balance:
get:
operationId: get-openApi-swap-v3-user-balance
summary: Query account data
tags:
- Perpetual Futures (USDT-M)
responses:
'200':
description: Successful response. BingX wraps results as {code, msg, data}; code 0 means success.
x-rate-limit: 5/second
x-ip-rate-limit-weight: '3'
components:
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-BX-APIKEY
description: API key header; private endpoints also require timestamp and an HMAC SHA256 signature query parameter.