{ "openapi": "3.0.3", "info": { "title": "MEXC Spot REST API v3", "description": "MEXC Spot REST API (v3) providing programmatic access to spot trading, market data, account management, and wallet operations.", "version": "1.0.0" }, "servers": [ { "url": "https://api.mexc.com" } ], "paths": { "/api/v3/ping": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Test Connectivity", "operationId": "test_connectivity", "description": "Test Connectivity", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/time": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Check Server Time", "operationId": "check_server_time", "description": "Check Server Time", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/exchangeInfo": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Exchange Information", "operationId": "exchange_information", "description": "Exchange Information", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/depth": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Order Book", "operationId": "order_book", "description": "Order Book", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/trades": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Recent Trades List", "operationId": "recent_trades_list", "description": "Recent Trades List", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/historicalTrades": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Old Trade Lookup", "operationId": "old_trade_lookup", "description": "Old Trade Lookup", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/aggTrades": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Compressed/Aggregate Trades List", "operationId": "compressed_aggregate_trades_list", "description": "Compressed/Aggregate Trades List", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/klines": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Kline/Candlestick Data", "operationId": "kline_candlestick_data", "description": "Kline/Candlestick Data", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "ENUM: Kline interval", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/avgPrice": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Current Average Price", "operationId": "current_average_price", "description": "Current Average Price", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/ticker/24hr": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "24hr Ticker Price Change Statistics", "operationId": "24hr_ticker_price_change_statistics", "description": "24hr Ticker Price Change Statistics", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/ticker/price": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Symbol Price Ticker", "operationId": "symbol_price_ticker", "description": "Symbol Price Ticker", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/ticker/bookTicker": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Symbol Order Book Ticker", "operationId": "symbol_order_book_ticker", "description": "Symbol Order Book Ticker", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/defaultSymbols": { "get": { "tags": [ "Market Date Endpoints" ], "summary": "Default Symbols", "operationId": "default_symbols", "description": "Default Symbols", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/order/test": { "post": { "tags": [ "Spot Account/Trade" ], "summary": "Test New Order", "operationId": "test_new_order", "description": "Test New Order", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "side", "in": "query", "description": "ENUM\uff1aOrder Side", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "ENUM\uff1aOrder Type", "required": false, "schema": { "type": "string" } }, { "name": "quantity", "in": "query", "description": "Quantity", "required": false, "schema": { "type": "string" } }, { "name": "price", "in": "query", "description": "Price", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/order": { "post": { "tags": [ "Spot Account/Trade" ], "summary": "New Order", "operationId": "new_order", "description": "New Order", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "side", "in": "query", "description": "ENUM\uff1aOrder Side", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "ENUM\uff1aOrder Type ", "required": false, "schema": { "type": "string" } }, { "name": "quantity", "in": "query", "description": "Quantity", "required": false, "schema": { "type": "string" } }, { "name": "price", "in": "query", "description": "Price", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "delete": { "tags": [ "Spot Account/Trade" ], "summary": "Cancel Orde", "operationId": "cancel_orde", "description": "Cancel Orde", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "orderId", "in": "query", "description": "Order id", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Spot Account/Trade" ], "summary": "Query Order", "operationId": "query_order", "description": "Query Order", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "orderId", "in": "query", "description": "Order id", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/openOrders": { "delete": { "tags": [ "Spot Account/Trade" ], "summary": "Cancel all Open Orders on a Symbol", "operationId": "cancel_all_open_orders_on_a_symbol", "description": "Cancel all Open Orders on a Symbol", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Spot Account/Trade" ], "summary": "Current Open Orders", "operationId": "current_open_orders", "description": "Current Open Orders", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/allOrders": { "get": { "tags": [ "Spot Account/Trade" ], "summary": "All Orders", "operationId": "all_orders", "description": "All Orders", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/account": { "get": { "tags": [ "Spot Account/Trade" ], "summary": "Account Information", "operationId": "account_information", "description": "Account Information", "parameters": [ { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/myTrades": { "get": { "tags": [ "Spot Account/Trade" ], "summary": "Account Trade List", "operationId": "account_trade_list", "description": "Account Trade List", "parameters": [ { "name": "symbol", "in": "query", "description": "Symbol", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/selfSymbols": { "get": { "tags": [ "Spot Account/Trade" ], "summary": "Query Self Symbols", "operationId": "query_self_symbols", "description": "Query Self Symbols", "parameters": [ { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/mxDeduct/enable": { "post": { "tags": [ "Spot Account/Trade" ], "summary": "MxDeduct enable", "operationId": "mxdeduct_enable", "description": "MxDeduct enable", "parameters": [ { "name": "mxDeductEnable", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Spot Account/Trade" ], "summary": "Query MxDeduct", "operationId": "query_mxdeduct", "description": "Query MxDeduct", "parameters": [ { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/etf/info": { "get": { "tags": [ "EFT" ], "summary": "ETF info", "operationId": "etf_info", "description": "ETF info", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/withdraw/apply": { "post": { "tags": [ "Wallet" ], "summary": "Withdraw Apply", "operationId": "withdraw_apply", "description": "Withdraw Apply", "parameters": [ { "name": "coin", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "network", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "address", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/deposit/hisrec": { "get": { "tags": [ "Wallet" ], "summary": "Query Deposit Hisrec", "operationId": "query_deposit_hisrec", "description": "Query Deposit Hisrec", "parameters": [ { "name": "coin", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/config/getall": { "get": { "tags": [ "Wallet" ], "summary": "Query All Coins", "operationId": "query_all_coins", "description": "Query All Coins", "parameters": [ { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/broker/sub-account/apiKey": { "post": { "tags": [ "Wallet" ], "summary": "Get Listen Key", "operationId": "get_listen_key", "description": "Get Listen Key", "parameters": [ { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/transfer": { "post": { "tags": [ "Wallet" ], "summary": "Transfer", "operationId": "transfer", "description": "Transfer", "parameters": [ { "name": "fromAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Wallet" ], "summary": "Transfer Record", "operationId": "transfer_record", "description": "Transfer Record", "parameters": [ { "name": "fromAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/withdraw/history": { "get": { "tags": [ "Wallet" ], "summary": "Withdraw History", "operationId": "withdraw_history", "description": "Withdraw History", "parameters": [ { "name": "coin", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/transfer/tranId": { "get": { "tags": [ "Wallet" ], "summary": "Query Transfer By TranId", "operationId": "query_transfer_by_tranid", "description": "Query Transfer By TranId", "parameters": [ { "name": "tranId", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/deposit/address": { "post": { "tags": [ "Wallet" ], "summary": "Generate Deposit Address", "operationId": "generate_deposit_address", "description": "Generate Deposit Address", "parameters": [ { "name": "coin", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "network", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Wallet" ], "summary": "Query Deposit Address", "operationId": "query_deposit_address", "description": "Query Deposit Address", "parameters": [ { "name": "coin", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/convert/list": { "get": { "tags": [ "Wallet" ], "summary": "Get Assets That Can Be Converted Into MX", "operationId": "get_assets_that_can_be_converted_into_mx", "description": "Get Assets That Can Be Converted Into MX", "parameters": [ { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/convert": { "post": { "tags": [ "Wallet" ], "summary": "Dust Transfer", "operationId": "dust_transfer", "description": "Dust Transfer", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Wallet" ], "summary": "DustLog", "operationId": "dustlog", "description": "DustLog", "parameters": [ { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/tradeMode": { "post": { "tags": [ "Margin" ], "summary": "Change Trade Mode", "operationId": "change_trade_mode", "description": "Change Trade Mode", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "tradeMode", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/order": { "post": { "tags": [ "Margin" ], "summary": "Margin Account New Order", "operationId": "margin_account_new_order", "description": "Margin Account New Order", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "side", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "quantity", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "price", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "delete": { "tags": [ "Margin" ], "summary": "Margin Account Cancel Order", "operationId": "margin_account_cancel_order", "description": "Margin Account Cancel Order", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "orderId", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's order", "operationId": "query_margin_account_s_order", "description": "Query Margin Account's order", "parameters": [ { "name": "orderId", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/loan": { "post": { "tags": [ "Margin" ], "summary": "Margin Account Borrow", "operationId": "margin_account_borrow", "description": "Margin Account Borrow", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "isIsolated", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Margin" ], "summary": "Query Loan Record", "operationId": "query_loan_record", "description": "Query Loan Record", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/repay": { "post": { "tags": [ "Margin" ], "summary": "Margin Account Repay", "operationId": "margin_account_repay", "description": "Margin Account Repay", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "borrowId", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Margin" ], "summary": "Query Repay Record", "operationId": "query_repay_record", "description": "Query Repay Record", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/openOrders": { "delete": { "tags": [ "Margin" ], "summary": "Margin Account Cancel all Open Orders on a Symbol", "operationId": "margin_account_cancel_all_open_orders_on_a_symbol", "description": "Margin Account Cancel all Open Orders on a Symbol", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's Open Order", "operationId": "query_margin_account_s_open_order", "description": "Query Margin Account's Open Order", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/allOrders": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's All Order", "operationId": "query_margin_account_s_all_order", "description": "Query Margin Account's All Order", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/myTrades": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's Trade List", "operationId": "query_margin_account_s_trade_list", "description": "Query Margin Account's Trade List", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/maxTransferable": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's maxTransferable", "operationId": "query_margin_account_s_maxtransferable", "description": "Query Margin Account's maxTransferable", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/priceIndex": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's priceIndex", "operationId": "query_margin_account_s_priceindex", "description": "Query Margin Account's priceIndex", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/isolated/account": { "get": { "tags": [ "Margin" ], "summary": "Query Isolated Margin Account Info", "operationId": "query_isolated_margin_account_info", "description": "Query Isolated Margin Account Info", "parameters": [ { "name": "symbols", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/trigerOrder": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's trigerOrder", "operationId": "query_margin_account_s_trigerorder", "description": "Query Margin Account's trigerOrder", "parameters": [ { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/maxBorrowable": { "get": { "tags": [ "Margin" ], "summary": "Query Margin Account's maxBorrowable", "operationId": "query_margin_account_s_maxborrowable", "description": "Query Margin Account's maxBorrowable", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/isolated/pair": { "get": { "tags": [ "Margin" ], "summary": "Query Solated Pair", "operationId": "query_solated_pair", "description": "Query Solated Pair", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/margin/forceLiquidationRec": { "get": { "tags": [ "Margin" ], "summary": "Query forceLiquidationRec", "operationId": "query_forceliquidationrec", "description": "Query forceLiquidationRec", "parameters": [ { "name": "symbol", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/sub-account/virtualSubAccount": { "post": { "tags": [ "Parent child account" ], "summary": "new virtualSubAccount", "operationId": "new_virtualsubaccount", "description": "new virtualSubAccount", "parameters": [ { "name": "subAccount", "in": "query", "description": "subAccount", "required": false, "schema": { "type": "string" } }, { "name": "note", "in": "query", "description": "remarks", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/sub-account/list": { "get": { "tags": [ "Parent child account" ], "summary": "Query sub-account list", "operationId": "query_sub_account_list", "description": "Query sub-account list", "parameters": [ { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/sub-account/apiKey": { "post": { "tags": [ "Parent child account" ], "summary": "new sub-account apiKey", "operationId": "new_sub_account_apikey", "description": "new sub-account apiKey", "parameters": [ { "name": "subAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "note", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "permissions", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Parent child account" ], "summary": "Query sub-account apiKey", "operationId": "query_sub_account_apikey", "description": "Query sub-account apiKey", "parameters": [ { "name": "subAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "delete": { "tags": [ "Parent child account" ], "summary": "Delete sub-account apiKey", "operationId": "delete_sub_account_apikey", "description": "Delete sub-account apiKey", "parameters": [ { "name": "subAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "apiKey", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "text/plain": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/capital/sub-account/universalTransfer": { "post": { "tags": [ "Parent child account" ], "summary": "Sub-account UniversalTransfer", "operationId": "sub_account_universaltransfer", "description": "Sub-account UniversalTransfer", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "fromAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "fromAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "clientTranId", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] }, "get": { "tags": [ "Parent child account" ], "summary": "Query Sub-account UniversalTransfer Record", "operationId": "query_sub_account_universaltransfer_record", "description": "Query Sub-account UniversalTransfer Record", "parameters": [ { "name": "asset", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "fromAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccountType", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "toAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/sub-account/futures": { "post": { "tags": [ "Parent child account" ], "summary": "Enable Futures For Sub-account", "operationId": "enable_futures_for_sub_account", "description": "Enable Futures For Sub-account", "parameters": [ { "name": "subAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/sub-account/margin": { "post": { "tags": [ "Parent child account" ], "summary": "Enable Margin For Sub-account", "operationId": "enable_margin_for_sub_account", "description": "Enable Margin For Sub-account", "parameters": [ { "name": "subAccount", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/rebate/taxQuery": { "get": { "tags": [ "Rebate" ], "summary": "Get Rebate History Records", "operationId": "get_rebate_history_records", "description": "Get Rebate History Records", "parameters": [ { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/rebate/detail": { "get": { "tags": [ "Rebate" ], "summary": "Get Rebate Records Detail", "operationId": "get_rebate_records_detail", "description": "Get Rebate Records Detail", "parameters": [ { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/rebate/detail/kickback": { "get": { "tags": [ "Rebate" ], "summary": "Get Self Rebate Records Detail", "operationId": "get_self_rebate_records_detail", "description": "Get Self Rebate Records Detail", "parameters": [ { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } }, "/api/v3/rebate/referCode": { "get": { "tags": [ "Rebate" ], "summary": "Query ReferCode", "operationId": "query_refercode", "description": "Query ReferCode", "parameters": [ { "name": "recvWindow", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "timestamp", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "signature", "in": "query", "description": "", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-MEXC-APIKEY" } } } }