FAQs
Q1: How many API Keys can a user apply?
Each account can create up to 30 API Keys. The validity of an API Key without a linked IP address is 90 days, and the API Key will expire automatically. Each API Key can be linked to a maximum of 10 IP addresses.

Q2: How many sub-accounts can a main account apply?
Each main account can create up to 30 sub-accounts. The sub-accounts will automatically inherit the main account rates. However, sub-accounts created via API cannot be logged in on Web.

Q3: Why are there often issues of disconnections and expired sessions?
If stable access is not possible, it is recommended to use Japan or Singapore AWS cloud servers for access.

Q4: What should I do after an error is reported for exceeding the limit frequency?
After exceeding the interface access frequency limit, you will not be able to continue accessing the interface. It will resume to normal after 10 minutes to keep the interface access frequency below the limit.

Q5: How many orders can an account place?
Each account can hold up to 500 valid orders that are not completely filled.

Q6:Why does WebSocket always disconnect?
If there is no valid subscription, it will disconnect in 30 seconds.
If the subscription is successful, and there is no traffic in 60 seconds, it will automatically disconnect.
To ensure a stable connection, a Pong reply is required upon receiving the Ping message sent from the server.
Q7: Why am I unable to subcribe to multiple channels on WebSocket?
WebSocket currently allows subscription to up to 30 channels via a single link. Any subscription will be invalid after the limit is exceeded. To subscribe to more channels, it is recommended to create multiple links.

General Info
Base endpoint
The base endpoint is:

https://api.mexc.com
HTTP Return Codes
HTTP 4XX return codes are used for malformed requests; the issue is on the sender's side.
HTTP 403 return code is used when the WAF Limit (Web Application Firewall) has been violated.
HTTP 429 return code is used when breaking a request rate limit.
HTTP 5XX return codes are used for internal errors; the issue is on MEXC's side. It is important to NOT treat this as a failure operation; the execution status is UNKNOWN and could have been a success.
General Information on Endpoints
The API accepts requests of type GET, POST or DELETE

For GET endpoints, parameters must be sent as a query string.
For POST, PUT, and DELETE endpoints, the parameters may be sent as a query string with content type application/x-www-form-urlencoded,or in the request body with content type application/json. You may mix parameters between both the query string and request body if you wish to do so.
Parameters may be sent in any order.
If a parameter sent in both the query string and request body, the query string parameter will be used.
Header
Relevant parameters in the header

key	Description
X-MEXC-APIKEY	Access key
Content-Type	application/json
SIGNED
SIGNED endpoints require an additional parameter, signature, to be sent in the query string or request body(in the API of batch operation, if there are special symbols such as comma in the parameter value, these symbols need to be URL encoded when signing,and encode only support uppercase).
Endpoints use HMAC SHA256 signatures. The HMAC SHA256 signature is a keyed HMAC SHA256 operation. Use your secretKey as the key and totalParams as the value for the HMAC operation.
The signature is support lowercase only.
totalParams is defined as the query string concatenated with the request body.
Timing security
The logic is as follows:

 if (timestamp < (serverTime + 1000) && (serverTime - timestamp) <= recvWindow)
  {
    // process request
  } 
  else 
  {
    // reject request
  }
A SIGNED endpoint also requires a parameter, timestamp, to be sent which should be the millisecond timestamp of when the request was created and sent.
An additional parameter, recvWindow, may be sent to specify the number of milliseconds after timestamp the request is valid for. If recvWindow is not sent, it defaults to 5000.
Serious trading is about timing. Networks can be unstable and unreliable, which can lead to requests taking varying amounts of time to reach the servers. With recvWindow, you can specify that the request must be processed within a certain number of milliseconds or be rejected by the server.

 It is recommended to use a small recvWindow of 5000 or less! The max cannot go beyond 60,000!
SIGNED Endpoint Examples for POST /api/v3/order
Example 1

HMAC SHA256 signature:

    $ echo -n "symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087" | openssl dgst -sha256 -hmac "45d0b3c26f2644f19bfb98b07741b2f5"
    (stdin)= 323c96ab85a745712e95e63cad28903dd8292e4a905e99c4ee3932023843a117
curl command:

    (HMAC SHA256)
    $ curl -H "X-MEXC-APIKEY: mx0aBYs33eIilxBWC5" -X POST 'https://api.mexc.com/api/v3/order' -d 'symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087&signature=323c96ab85a745712e95e63cad28903dd8292e4a905e99c4ee3932023843a117'

Example 2

HMAC SHA256 signature:

    $ echo -n "symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087" | openssl dgst -sha256 -hmac "45d0b3c26f2644f19bfb98b07741b2f5"
    (stdin)= fd3e4e8543c5188531eb7279d68ae7d26a573d0fc5ab0d18eb692451654d837a
curl command:

    (HMAC SHA256)
    $ curl -H "X-MEXC-APIKEY: mx0aBYs33eIilxBWC5" -X POST 'https://api.mexc.com/api/v3/order' -d 'symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087&signature=fd3e4e8543c5188531eb7279d68ae7d26a573d0fc5ab0d18eb692451654d837a'

Example 3

HMAC SHA256 signature:

    $ echo -n "symbol=BTCUSDT&side=BUY&type=LIMITquantity=1&price=11&recvWindow=5000&timestamp=1644489390087" | openssl dgst -sha256 -hmac "45d0b3c26f2644f19bfb98b07741b2f5"
    (stdin)= d1a676610ceb39174c8039b3f548357994b2a34139a8addd33baadba65684592
curl command:

    (HMAC SHA256)
    $ curl -H "X-MEXC-APIKEY: mx0aBYs33eIilxBWC5" -X POST 'https://api.mexc.com/api/v3/order?symbol=BTCUSDT&side=BUY&type=LIMIT' -d 'quantity=1&price=11&recvWindow=5000&timestamp=1644489390087&signature=d1a676610ceb39174c8039b3f548357994b2a34139a8addd33baadba65684592'

Here is a step-by-step example of how to send a vaild signed payload from the Linux command line using echo, openssl, and curl.

Key	Value
apiKey	mx0aBYs33eIilxBWC5
secretKey	45d0b3c26f2644f19bfb98b07741b2f5
Parameter	Value
symbol	BTCUSDT
side	BUY
type	LIMIT
quantity	1
price	11
recvWindow	5000
timestamp	1644489390087
Example 1: As a request body
requestBody: symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087
Example 2: As a query string

queryString: symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087
Example 3: Mixed query string and request body

queryString: symbol=BTCUSDT&side=BUY&type=LIMIT

requestBody: quantity=1&price=11&recvWindow=5000&timestamp=1644489390087

Note that the signature is different in example 3. There is no & between "LIMIT" and "quantity=1".

LIMITS
There is rate limit for API access frequency, upon exceed client will get code 429: Too many requests. The account is used as the basic unit of speed limit for the endpoints that need to carry access keys. For endpoints that do not need to carry access keys, IP addresses are used as the basic unit of rate limiting.

Limits Description
According to the two modes of IP and UID (account) limit, each are independent.
Endpoints are marked according to IP or UID limit and their corresponding weight value.
Each endpoint with IP limits has an independent 500 every 10 second limit.
Each endpoint with UID limits has an independent 500 every 10 second limit.
Limits Error
When a 429 is received, it's your obligation as an API to back off and not spam the API.
Repeatedly violating rate limits and/or failing to back off after receiving 429s will result in an automated IP ban .
IP bans are tracked and scale in duration for repeat offenders, from 2 minutes to 3 days.
A Retry-After header is sent with a 418 or 429 responses and will give the number of seconds required to wait, in the case of a 429, to prevent a ban, or, in the case of a 418, until the ban is over.
Websocket Limits
The Websocket limits is: 100times/s.
A connection that goes beyond the limit will be disconnected; IPs that are repeatedly disconnected may be banned.
A single connection can listen to a maximum of 30 streams.
Error Code
The following error information can be returend

Code	Description
-2011	Unknown order sent
26	operation not allowed
400	api key required
401	No authority
403	Access Denied
429	Too Many Requests
500	Internal error
503	service not available, please try again
504	Gateway Time-out
602	Signature verification failed
10001	user does not exist
10007	bad symbol
10015	user id cannot be null
10072	invalid access key
10073	invalid Request-Time
10095	amount cannot be null
10096	amount decimal places is too long
10097	amount is error
10098	risk control system detected abnormal
10099	user sub account does not open
10100	this currency transfer is not supported
10101	Insufficient balance
10102	amount cannot be zero or negative
10103	this account transfer is not supported
10200	transfer operation processing
10201	transfer in failed
10202	transfer out failed
10206	transfer is disabled
10211	transfer is forbidden
10212	This withdrawal address is not on the commonly used address list or has been invalidated
10216	no address available. Please try again later
10219	asset flow writing failed please try again
10222	currency cannot be null
10232	currency does not exist
10259	Intermediate account does not configured in redisredis
10265	Due to risk control, withdrawal is unavailable, please try again later
10268	remark length is too long
20001	subsystem is not supported
20002	Internal system error please contact support
22222	record does not exist
30000	suspended transaction for the symbol
30001	The current transaction direction is not allowed to place an order
30002	The minimum transaction volume cannot be less than :
30003	The maximum transaction volume cannot be greater than :
30004	Insufficient position
30005	Oversold
30010	no valid trade price
30014	invalid symbol
30016	trading disabled
30018	market order is disabled
30019	api market order is disabled
30020	no permission for the symbol
30021	invalid symbol
30025	no exist opponent order
30026	invalid order ids
30027	The currency has reached the maximum position limit, the buying is suspended
30028	The currency triggered the platform risk control, the selling is suspended
30029	Cannot exceed the maximum order limit
30032	Cannot exceed the maximum position
30041	current order type can not place order
33333	param is error
44444	param cannot be null
60005	your account is abnormal
70011	Pair user ban trade apikey
700001	API-key format invalid
700002	Signature for this request is not valid
700003	Timestamp for this request is outside of the recvWindow
700004	Param 'origClientOrderId' or 'orderId' must be sent, but both were empty/null
700005	recvWindow must less than 60000
700006	IP non white list
700007	No permission to access the endpoint
700008	Illegal characters found in parameter
730001	Pair not found
730002	Your input param is invalid
730000	Request failed, please contact the customer service
730001	User information error
730002	Parameter error
730003	Unsupported operation, please contact the customer service
730100	Unusual user status
730600	Sub-account Name cannot be null
730601	Sub-account Name must be a combination of 8-32 letters and numbers
730602	Sub-account remarks cannot be null
730700	API KEY remarks cannot be null
730701	API KEY permission cannot be null
730702	API KEY permission does not exist
730703	The IP information is incorrect, and a maximum of 10 IPs are allowed to be bound only
730704	The bound IP format is incorrect, please refill
730705	At most 30 groups of Api Keys are allowed to be created only
730706	API KEY information does not exist
730707	accessKey cannot be null
730101	The user Name already exists
140001	sub account does not exist
140002	sub account is forbidden
Market Data Endpoints
Download Historical Market Data
Provides kline and trading data for all Spot pairs since 01-01-2023:Historical Market Data

Test Connectivity
Response

{}
GET /api/v3/ping
Test connectivity to the Rest API.

Weight(IP): 1

Parameter:

NONE

Check Server Time
Response

{
    "serverTime" : 1645539742000
}
GET /api/v3/time
Weight(IP): 1

Parameter:

NONE

API default symbol
Request

GET /api/v3/defaultSymbols
Response

{
    "code": 200,
    "data": [
        "GENE1USDT",
        "SNTUSDT",
        "SQUAWKUSDT",
        "HEGICUSDT",
        "GUMUSDT"
    ],
    "msg": null
}
GET /api/v3/defaultSymbols
Weight(IP): 1

Request

NONE

Response

Name	Type	Description
symbol	string	symbol
Exchange Information
Response

{
    "symbol": "TOMO3LUSDT",
    "status": "ENABLED",
    "baseAsset": "TOMO3L",
    "baseAssetPrecision": 2,
    "quoteAsset": "USDT",
    "quotePrecision": 3,
    "quoteAssetPrecision": 3,
    "baseCommissionPrecision": 2,
    "quoteCommissionPrecision": 3,
    "orderTypes": [
        "LIMIT",
        "LIMIT_MAKER"
    ],
    "quoteOrderQtyMarketAllowed": false,
    "isSpotTradingAllowed": false,
    "isMarginTradingAllowed": false,
    "quoteAmountPrecision": "5",
    "baseSizePrecision": "0.0001",
    "permissions": [
        "SPOT",
        "LIMIT"
    ],
    "filters": [],
    "maxQuoteAmount": "5000000",
    "makerCommission": "0.002",
    "takerCommission": "0.002",
    "tradeSideType":"1"
}

GET /api/v3/exchangeInfo
Current exchange trading rules and symbol information

Weight(IP): 10

Parameter:

There are 3 possible options:

Method	Example
No parameter	curl -X GET "https://api.mexc.com/api/v3/exchangeInfo"
symbol	curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbol=MXUSDT"
symbols	curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbols=MXUSDT,BTCUSDT"
Response:

Name	Type	Description
timezone	string	timezone
serverTime	long	server Time
rateLimits	Array	rate Limits
exchangeFilters	Array	exchange Filters
symbol	String	symbol
status	String	status:1 - online, 2 - Pause, 3 - offline
baseAsset	String	base Asset
baseAssetPrecision	Int	base Asset Precision
quoteAsset	String	quote Asset
quotePrecision	Int	quote Precision
quoteAssetPrecision	Int	quote Asset Precision
baseCommissionPrecision	Int	base Commission Precision
quoteCommissionPrecision	Int	quote Commission Precision
orderTypes	Array	Order Type
quoteOrderQtyMarketAllowed	Boolean	quoteOrderQtyMarketAllowed
isSpotTradingAllowed	Boolean	allow api spot trading
isMarginTradingAllowed	Boolean	allow api margin trading
permissions	Array	permissions
maxQuoteAmount	String	max Quote Amount
makerCommission	String	marker Commission
takerCommission	String	taker Commission
quoteAmountPrecision	string	min order amount
baseSizePrecision	string	min order quantity
quoteAmountPrecisionMarket	string	min order amount in market order
maxQuoteAmountMarket	String	max quote Amount in market order
tradeSideType	String	tradeSide Type:1 - All, 2 - buy order only, 3 - Sell order only, 4 - Close
Order Book
Response

{
  "lastUpdateId": 1112416,
  "bids": [
      ["15.00000", "49999.00000"]
  ],
  "asks": [
    ["14.0000", "1.0000"]
  ]
}
GET /api/v3/depth
Weight(IP): 1

Parameter:

Name	Type	Mandatory	Description	Scope
symbol	string	YES	Symbol	
limit	integer	NO	Returen number	default 100; max 5000
Response:

Name	Type	Description
lastUpdateId	long	Last Update Id
bids	list	Bid [Price, Quantity ]
asks	list	Ask [Price, Quantity ]
Recent Trades List
Response

[
  {
    "id": null,
    "price": "23",
    "qty": "0.478468",
    "quoteQty": "11.004764",
    "time": 1640830579240,
    "isBuyerMaker": true,
    "isBestMatch": true
  }
]
GET /api/v3/trades
Weight(IP): 5

Parameter:

Name	Type	Mandatory	Description	Scope
symbol	string	YES		
limit	integer	NO		Default 500; max 1000
Response:

Name	Description
id	Trade id
price	Price
qty	Number
quoteQty	Trade total
time	Trade time
isBuyerMaker	Was the buyer the maker?
isBestMatch	Was the trade the best price match?
Compressed/Aggregate Trades List
Response

[
  {
    "a": null,
    "f": null,
    "l": null,
    "p": "46782.67",
    "q": "0.0038",
    "T": 1641380483000,
    "m": false,
    "M": true
  }
]
GET /api/v3/aggTrades
Weight(IP): 1

Get compressed, aggregate trades. Trades that fill at the time, from the same order, with the same price will have the quantity aggregated.

Parameters:

Name	Type	Mandatory	Description	Scope
symbol	string	YES		
startTime	long	NO	Timestamp in ms to get aggregate trades from INCLUSIVE.	
endTime	long	NO	Timestamp in ms to get aggregate trades until INCLUSIVE.	
limit	integer	NO		Default 500; max 1000.
startTime and endTime must be used at the same time.

Response:

Name	Description
a	Aggregate tradeId
f	First tradeId
l	Last tradeId
p	Price
q	Quantity
T	Timestamp
m	Was the buyer the maker?
M	Was the trade the best price match?
Kline/Candlestick Data
Response

[
  [
    1640804880000, 
    "47482.36", 
    "47482.36", 
    "47416.57", 
    "47436.1", 
    "3.550717", 
    1640804940000, 
    "168387.3"
  ]
]
GET /api/v3/klines
Weight(IP): 1

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	
interval	ENUM	YES	ENUM: Kline Interval
startTime	long	NO	
endTime	long	NO	
limit	integer	NO	Default 500; max 1000.
Response:

Index	Description
0	Open time
1	Open
2	High
3	Low
4	Close
5	Volume
6	Close time
7	Quote asset volume
Current Average Price
Response

{
  "mins": 5,
  "price": "9.35751834"
}
GET /api/v3/avgPrice
Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	
Response:

Name	Description
mins	Average price time frame
price	Price
24hr Ticker Price Change Statistics
Response

{
    "symbol": "BTCUSDT",
    "priceChange": "184.34",
    "priceChangePercent": "0.00400048",
    "prevClosePrice": "46079.37",
    "lastPrice": "46263.71",
    "bidPrice": "46260.38",
    "bidQty": "",
    "askPrice": "46260.41",
    "askQty": "",
    "openPrice": "46079.37",
    "highPrice": "47550.01",
    "lowPrice": "45555.5",
    "volume": "1732.461487",
    "quoteVolume": null,
    "openTime": 1641349500000,
    "closeTime": 1641349582808,
    "count": null
}
or
[
  {
    "symbol": "BTCUSDT",
    "priceChange": "184.34",
    "priceChangePercent": "0.00400048",
    "prevClosePrice": "46079.37",
    "lastPrice": "46263.71",
    "bidPrice": "46260.38",
    "bidQty": "",
    "askPrice": "46260.41",
    "askQty": "",
    "openPrice": "46079.37",
    "highPrice": "47550.01",
    "lowPrice": "45555.5",
    "volume": "1732.461487",
    "quoteVolume": null,
    "openTime": 1641349500000,
    "closeTime": 1641349582808,
    "count": null
  },
  {
    "symbol": "ETHUSDT",
    "priceChange": "184.34",
    "priceChangePercent": "0.00400048",
    "prevClosePrice": "46079.37",
    "lastPrice": "46263.71",
    "bidPrice": "46260.38",
    "bidQty": "",
    "askPrice": "46260.41",
    "askQty": "",
    "openPrice": "46079.37",
    "highPrice": "47550.01",
    "lowPrice": "45555.5",
    "volume": "1732.461487",
    "quoteVolume": null,
    "openTime": 1641349500000,
    "closeTime": 1641349582808,
    "count": null
  }
]
GET /api/v3/ticker/24hr
Weight(IP):

Parameter	Symbols Provided	Weight
symbol	1	1
symbols	all	40
Parameters:

Name	Type	Mandatory	Description
symbol	string	NO	If the symbol is not sent, tickers for all symbols will be returned in an array.
Response:

Name	Description
symbol	Symbol
priceChange	price Change
priceChangePercent	price change percent
prevClosePrice	Previous close price
lastPrice	Last price
lastQty	Last quantity
bidPrice	Bid best price
bidQty	Bid best quantity
askPrice	Ask best price
askQty	Ask best quantity
openPrice	Open
highPrice	High
lowPrice	Low
volume	Deal volume
quoteVolume	Quote asset volume
openTime	Start time
closeTime	Close time
count	
Symbol Price Ticker
Response

{
    "symbol": "BTCUSDT",
    "price": "184.34"
}
or
[
  {
    "symbol": "BTCUSDT",
    "price": "6.65"
  },
  {
    "symbol": "ETHUSDT",
    "price": "5.65"
  }
]
GET /api/v3/ticker/price
Weight(IP):

Parameter	Symbols Provided	Weight
symbol	1	1
symbols	all	2
Parameters:

Name	Type	Mandatory	Description
symbol	string	NO	If the symbol is not sent, all symbols will be returned in an array.
Response:

Name	Description
symbol	
price	Last price
Symbol Order Book Ticker
Response

{
  "symbol": "AEUSDT",
  "bidPrice": "0.11001",
  "bidQty": "115.59",
  "askPrice": "0.11127",
  "askQty": "215.48"
}
OR
[
  {
    "symbol": "AEUSDT",
    "bidPrice": "0.11001",
    "bidQty": "115.59",
    "askPrice": "0.11127",
    "askQty": "215.48"
  },
  {
    "symbol": "AEUSDT",
    "bidPrice": "0.11001",
    "bidQty": "115.59",
    "askPrice": "0.11127",
    "askQty": "215.48"
  }
]
GET /api/v3/ticker/bookTicker
Weight(IP): 1

Best price/qty on the order book for a symbol or symbols.

Parameters:

Name	Type	Mandatory	Description
symbol	string	NO	If the symbol is not sent, all symbols will be returned in an array.
Response:

Name	Description
symbol	Symbol
bidPrice	Best bid price
bidQty	Best bid quantity
askPrice	Best ask price
askQty	Best ask quantity
Sub-Account Endpoints
Create a Sub-account(For Master Account)
Create a sub-account from the master account.

Response

{
    "subAccount":"mexc1",
    "note":"1"
}
POST / api/v3/sub-account/virtualSubAccount
Permission: SPOT_ACCOUNT_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
subAccount	STRING	YES	Sub-account Name
note	STRING	YES	Sub-account notes
recvWindow	LONG	NO	
timestamp	LONG	YES	
Query Sub-account List (For Master Account)
Get details of the sub-account list

Response

{
    "subAccounts":[
        {
            "subAccount":"mexc666",
            "isFreeze":false,
            "createTime":1544433328000,
            "uid": "49910511"
        },
        {
            "subAccount":"mexc888",
            "isFreeze":false,
            "createTime":1544433328000,
            "uid": "91921059"
        }
    ]
}
GET / api/v3/sub-account/list
Permission: SPOT_ACCOUNT_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
subAccount	STRING	NO	Sub-account Name
isFreeze	STRING	NO	true or false
page	INT	NO	Default value: 1
limit	INT	NO	Default value: 10, Max value: 200
timestamp	LONG	YES	
recvWindow	LONG	NO	
Response:

Name	Description
subAccount	subAccount name
isFreeze	isFreeze
createTime	createTime
uid	subaccount uid
Create an APIKey for a sub-account (For Master Account)
Response

    {
        "subAccount": "mexc1",
        "note": "1",
        "apiKey": "arg13sdfgs",
        "secretKey": "nkjwn21973ihi",
        "permissions": "SPOT_ACCOUNT_READ",
        "ip": "135.181.193",
        "creatTime": 1597026383085
    }
POST /api/v3/sub-account/apiKey
Permission: SPOT_ACCOUNT_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
subAccount	STRING	YES	Sub-account Name
note	STRING	YES	APIKey note
permissions	STRING	YES	Permission of APIKey:
SPOT_ACCOUNT_READ,
SPOT_ACCOUNT_WRITE,
SPOT_DEAL_READ,
SPOT_DEAL_WRITE,
CONTRACT_ACCOUNT_READ,
CONTRACT_ACCOUNT_WRITE,
CONTRACT_DEAL_READ,
CONTRACT_DEAL_WRITE,
SPOT_TRANSFER_READ,
SPOT_TRANSFER_WRITE
ip	STRING	NO	Link IP addresses, separate with commas if more than one. Support up to 20 addresses.
recvWindow	LONG	NO	
timestamp	LONG	YES	
Query the APIKey of a sub-account (For Master Account)
Applies to master accounts only

Response

   {
       "subAccount":[
        {
            "note":"v5",
            "apiKey":"arg13sdfgs",
            "permissions":"SPOT_ACCOUNT_READ,SPOT_ACCOUNT_WRITE",
            "ip":"1.1.1.1,2.2.2.2",
            "creatTime":1597026383085
        },
        {
            "note":"v5.1",
            "apiKey":"arg13sdfgs12",
            "permissions":"SPOT_ACCOUNT_READ,SPOT_ACCOUNT_WRITE",
            "ip":"1.1.1.1,2.2.2.2",
            "creatTime":1597026383085
        }
        ]
   }
GET/api/v3/sub-account/apiKey
Permission: SPOT_ACCOUNT_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
subAccount	STRING	YES	Sub-account Name
recvWindow	LONG	NO	
timestamp	LONG	YES	
Delete the APIKey of a sub-account (For Master Account)
Response

  {
           "subAccount":"mexc1"
}
DELETE /api/v3/sub-account/apiKey
Permission: SPOT_ACCOUNT_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
subAccount	STRING	YES	Sub-account Name
apiKey	STRING	YES	API public key
recvWindow	LONG	NO	
timestamp	LONG	YES	
Universal Transfer (For Master Account)
Request

post /api/v3/capital/sub-account/universalTransfer
Response

 {
    "tranId":11945860693 
 }
POST /api/v3/capital/sub-account/universalTransfer
Permission: SPOT_TRANSFER_WRITE

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
fromAccount	string	NO	Transfer from master account by default if fromAccount is not sent
toAccount	string	NO	Transfer to master account by default if toAccount is not sent
fromAccountType	string	YES	fromAccountType:"SPOT","FUTURES"
toAccountType	string	YES	toAccountType:"SPOT","FUTURES"
asset	string	YES	asset,eg:USDT
amount	string	YES	amount,eg:1.82938475
timestamp	string	YES	timestamp
signature	string	YES	sign
Response:

Name	Type	Description
tranId	string	transfer ID
Query Universal Transfer History (For Master Account)
Request

get /api/v3/capital/sub-account/universalTransfer
Response

  {
    "tranId":"11945860693",
    "fromAccount":"master@test.com",
    "toAccount":"subaccount1@test.com",
    "clientTranId":"test",
    "asset":"BTC",
    "amount":"0.1",
    "fromAccountType":"SPOT",
    "toAccountType":"FUTURE",
    "fromSymbol":"SPOT",
    "toSymbol":"FUTURE",
    "status":"SUCCESS",
    "timestamp":1544433325000
  }
GET /api/v3/capital/sub-account/universalTransfer
Permission: SPOT_TRANSFER_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
fromAccount	string	NO	Transfer from master account by default if fromAccount is not sent
toAccount	string	NO	Transfer to master account by default if toAccount is not sent
fromAccountType	string	YES	fromAccountType:"SPOT","FUTURES"
toAccountType	string	YES	toAccountType:"SPOT","FUTURES"
startTime	string	NO	startTime
endTime	string	NO	endTime
page	string	NO	default 1
limit	string	NO	default 500, max 500
timestamp	string	YES	timestamp
signature	string	YES	sign
Response:

Name	Type	Description
tranId	string	transfer ID
fromAccount	string	fromAccount
toAccount	string	toAccount
clientTranId	string	clientTranId
asset	string	asset
amount	string	transfer amount
fromAccountType	string	fromAccountType
toAccountType	string	toAccountType
fromSymbol	string	fromSymbol
toSymbol	string	toSymbol
status	string	status
timestamp	number	timestamp
Query Sub-account Asset
request

get /api/v3/sub-account/asset?subAccount=account1&accountType=SPOT&timestamp={{timestamp}}&signature={{signature}}
response

{
    "balances": [
        {
            "asset": "MX",
            "free": "3",
            "locked": "0"
        },
        {
            "asset": "BTC",
            "free": "0.0003",
            "locked": "0"
        }
    ]
}
GET /api/v3/sub-account/asset
Permission: SPOT_TRANSFER_READ

Weight(IP): 1

request

Name	Type	Mandatory	Description
subAccount	string	Yes	subAccount name,only support query for single subaccount
accountType	string	Yes	account type:"SPOT","FUTURES",only support SPOT currently
timestamp	string	Yes	timestamp
signature	string	Yes	signature
response

Name	Type	Description
balances	string	balance
asset	string	asset
free	string	free
locked	string	locked
Spot Account/Trade
User API default symbol
Request

GET /api/v3/selfSymbols?timestamp={{timestamp}}&signature={{signature}}
Response

{
    "code": 200,
    "data": [
        "GENE1USDT",
        "SNTUSDT",
        "SQUAWKUSDT",
        "HEGICUSDT",
        "GUMUSDT"
    ],
    "msg": null
}
GET /api/v3/selfSymbols
Permission: SPOT_ACCOUNT_R

Weight(IP): 1

Request

NONE

Response

Name	Type	Description
symbol	string	api trade symbol
Test New Order
Response

{}
POST /api/v3/order/test
Permission: SPOT_DEAL_WRITE

Weight(IP): 1

Creates and validates a new order but does not send it into the matching engine.

Parameters:

equaled POST /api/v3/order

New Order
Request

POST /api/v3/order?symbol=MXUSDT&side=BUY&type=LIMIT&quantity=50&price=0.1&timestamp={{timestamp}}&signature={{signature}}
Response

{
    "symbol": "MXUSDT",
    "orderId": "06a480e69e604477bfb48dddd5f0b750",
    "orderListId": -1,
    "price": "0.1",
    "origQty": "50",
    "type": "LIMIT",
    "side": "BUY",
    "transactTime": 1666676533741
}
POST /api/v3/order
Permission: SPOT_DEAL_WRITE

Weight(IP): 1, Weight(UID): 1

Parameters:

Name	type	Mandatory	Description
symbol	STRING	YES	
side	ENUM	YES	ENUM:Order Side
type	ENUM	YES	ENUM:Order Type
quantity	DECIMAL	NO	Quantity
quoteOrderQty	DECIMAL	NO	Quote order quantity
price	DECIMAL	NO	Price
newClientOrderId	STRING	NO	
recvWindow	LONG	NO	Max 60000
timestamp	LONG	YES	
Response:

Name	Description
symbol	Symbol
orderId	order id
orderListId	order list id
price	Price
origQty	Original order quantity
type	Order type
side	order side
transactTime	transactTime
Additional mandatory parameters based on type:

Type	Additional mandatory parameters
LIMIT	quantity, price
MARKET	quantity or quoteOrderQty
Other info:

MARKET: When type is market, quoteOrderQty or quantity required to choose anyone.

MARKET orders using the quantity field specifies the amount of the base asset the user wants to sell at the market price
For example, sending a MARKET order on BTCUSDT will specify how much BTC the user is selling.
MARKET orders using quoteOrderQty specifies the amount the user wants to spend (when buying) the quote asset; the correct quantity will be determined based on the market liquidity
Using BTCUSDT as an example:
On the BUY side, the order will buy as many BTC as quoteOrderQty USDT can.
On the SELL side, the order will sell the quantity of BTC.
Batch Orders
Supports 20 orders with a same symbol in a batch,rate limit:2 times/s.

Request

POST /api/v3/batchOrders?batchOrders=[{"type": "LIMIT_ORDER","price": "40000","quantity": "0.0002","symbol": "BTCUSDT","side": "BUY","newClientOrderId": 9588234},{"type": "LIMIT_ORDER","price": "4005","quantity": "0.0003","symbol": "BTCUSDT","side": "SELL"}]
Response

{
  { //success response:
   [
     {   
       "symbol": "BTCUSDT",   
       "orderId": "1196315350023612316",   
       "orderListId": -1 
     },
     {   
       "symbol": "BTCUSDT",   
       "orderId": "1196315350023612318",   
       "orderListId": -1 
     }
   ],
   //error response:
   [
     { 
       "symbol": "BTCUSDT", 
       "orderId": "1196315350023612316", 
       "newClientOrderId": "hio8279hbdsds", 
       "orderListId": -1 
     },
     { 
       "newClientOrderId": "123456",
       "msg": "The minimum transaction volume cannot be less than:0.5USDT", 
       "code": 30002
     },
     { 
       "symbol": "BTCUSDT", 
       "orderId": "1196315350023612318", 
       "orderListId": -1 
     }
   ] 
 }
}
POST /api/v3/batchOrders
Permission: SPOT_DEAL_WRITE

Weight(IP): 1,Weight(UID): 1

Parameters:

Name	type	Mandatory	Description
batchOrders	LIST	YES	list of batchOrders,supports max 20 orders
symbol	STRING	YES	symbol
side	ENUM	YES	order side
type	ENUM	YES	order type
quantity	DECIMAL	NO	quantity
quoteOrderQty	DECIMAL	NO	quoteOrderQty
price	DECIMAL	NO	order price
newClientOrderId	STRING	NO	ClientOrderId
recvWindow	LONG	NO	less than 60000
timestamp	LONG	YES	order time
base on differenttype,some params are mandatory:

type	Mandatory params
LIMIT	quantity, price
MARKET	quantity or quoteOrderQty
Response

Name	type	Description
symbol	STRING	symbol
orderId	STRING	orderId
Cancel Order
Response

{
  "symbol": "LTCBTC",
  "origClientOrderId": "myOrder1",
  "orderId": 4,
  "clientOrderId": "cancelMyOrder1",
  "price": "2.00000000",
  "origQty": "1.00000000",
  "executedQty": "0.00000000",
  "cummulativeQuoteQty": "0.00000000",
  "status": "CANCELED",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY"
}
DELETE /api/v3/order
Permission: SPOT_DEAL_WRITE

Weight(IP): 1

Cancel an active order.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	
orderId	string	NO	Order id
origClientOrderId	string	NO	
newClientOrderId	string	NO	
recvWindow	long	NO	
timestamp	long	YES	
Either orderId or origClientOrderId must be sent.

Response:

Name	Description
symbol	Symbol
origClientOrderId	Original client order id
orderId	order id
clientOrderId	client order id
price	Price
origOty	Original order quantity
executedQty	Executed order quantity
cummulativeQuoteQty	Cummulative quote quantity
status	order status
timeInForce	
type	Order type
side	order side
Cancel all Open Orders on a Symbol
Response

[
  {
    "symbol": "BTCUSDT",
    "origClientOrderId": "E6APeyTJvkMvLMYMqu1KQ4",
    "orderId": 11,
    "orderListId": -1,
    "clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
    "price": "0.089853",
    "origQty": "0.178622",
    "executedQty": "0.000000",
    "cummulativeQuoteQty": "0.000000",
    "status": "CANCELED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY"
  },
  {
    "symbol": "BTCUSDT",
    "origClientOrderId": "A3EF2HCwxgZPFMrfwbgrhv",
    "orderId": 13,
    "orderListId": -1,
    "clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
    "price": "0.090430",
    "origQty": "0.178622",
    "executedQty": "0.000000",
    "cummulativeQuoteQty": "0.000000",
    "status": "CANCELED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY"
  }
]
DELETE /api/v3/openOrders
Permission: SPOT_DEAL_WRITE

Weight(IP): 1

Cancel all pending orders for a single symbol, including OCO pending orders.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	maximum input 5 symbols,separated by ",". e.g. "BTCUSDT,MXUSDT,ADAUSDT"
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
symbol	Symbol
origClientOrderId	Original client order id
orderId	order id
clientOrderId	client order id
price	Price
origOty	Original order quantity
executedQty	Executed order quantity
cummulativeQuoteQty	Cummulative quote quantity
status	order status
timeInForce	
type	Order type
side	order side
Query Order
Response

{
  "symbol": "LTCBTC",
  "orderId": 1,
  "orderListId": -1,
  "clientOrderId": "myOrder1",
  "price": "0.1",
  "origQty": "1.0",
  "executedQty": "0.0",
  "cummulativeQuoteQty": "0.0",
  "status": "NEW",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY",
  "stopPrice": "0.0",
  "time": 1499827319559,
  "updateTime": 1499827319559,
  "isWorking": true,
  "origQuoteOrderQty": "0.000000"
}
GET /api/v3/order
Permission: SPOT_DEAL_READ

Weight(IP): 2

Check an order's status.

Parameters:

Name	Type	Mandatory	Description
symbol	String	YES	
origClientOrderId	String	NO	
orderId	String	NO	
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
symbol	Symbol
origClientOrderId	Original client order id
orderId	order id
clientOrderId	client order id
price	Price
origOty	Original order quantity
executedQty	Executed order quantity
cummulativeQuoteQty	Cummulative quote quantity
status	order status
timeInForce	
type	Order type
side	Order side
stopPrice	stop price
time	Order created time
updateTime	Last update time
isWorking	is orderbook
Current Open Orders
Response

[
  {
    "symbol": "LTCBTC",
    "orderId": 1,
    "orderListId": -1, 
    "clientOrderId": "myOrder1",
    "price": "0.1",
    "origQty": "1.0",
    "executedQty": "0.0",
    "cummulativeQuoteQty": "0.0",
    "status": "NEW",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "stopPrice": "0.0",
    "icebergQty": "0.0",
    "time": 1499827319559,
    "updateTime": 1499827319559,
    "isWorking": true,
    "origQuoteOrderQty": "0.000000"
  }
]
GET /api/v3/openOrders
Permission: SPOT_DEAL_READ

Weight(IP): 3

Get all open orders on a symbol. Careful when accessing this with no symbol.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
symbol	Symbol
origClientOrderId	Original client order id
orderId	order id
clientOrderId	client order id
price	Price
origOty	Original order quantity
executedQty	Executed order quantity
cummulativeQuoteQty	Cummulative quote quantity
status	order status
timeInForce	
type	Order type
side	Order side
stopPrice	stop price
time	Order created time
updateTime	Last update time
isWorking	is orderbook
All Orders
Response

[
  {
    "symbol": "LTCBTC",
    "orderId": 1,
    "orderListId": -1, 
    "clientOrderId": "myOrder1",
    "price": "0.1",
    "origQty": "1.0",
    "executedQty": "0.0",
    "cummulativeQuoteQty": "0.0",
    "status": "NEW",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "stopPrice": "0.0",
    "icebergQty": "0.0",
    "time": 1499827319559,
    "updateTime": 1499827319559,
    "isWorking": true,
    "origQuoteOrderQty": "0.000000"
  }
]
GET /api/v3/allOrders
Permission: SPOT_DEAL_READ

Weight(IP): 10

Get all account orders including active, cancelled or completed orders(the query period is the latest 24 hours by default). You can query a maximum of the latest 7 days.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	Symbol
startTime	long	NO	
endTime	long	NO	
limit	int	NO	Default 500; max 1000;
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
symbol	Symbol
origClientOrderId	Original client order id
orderId	order id
clientOrderId	client order id
price	Price
origOty	Original order quantity
executedQty	Executed order quantity
cummulativeQuoteQty	Cummulative quote quantity
status	order status
timeInForce	
type	Order type
side	Order side
stopPrice	stop price
time	Order created time
updateTime	Last update time
isWorking	is orderbook
origQuoteOrderQty	
Account Information
Response

{
    "canTrade": true,
    "canWithdraw": true,
    "canDeposit": true,
    "updateTime": null,
    "accountType": "SPOT",
    "balances": [{
        "asset": "NBNTEST",
        "free": "1111078",
        "locked": "33"
    }, {
        "asset": "MAIN",
        "free": "1020000",
        "locked": "0"
    }],
    "permissions": ["SPOT"]
}
GET /api/v3/account
Permission: SPOT_ACCOUNT_READ

Weight(IP): 10

Get current account information,rate limit:2 times/s.

Parameters:

Name	Type	Mandatory	Description
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
canTrade	Can Trade
canWithdraw	Can Withdraw
canDeposit	Can Deposit
updateTime	Update Time
accountType	Account type
balances	Balance
asset	Asset coin
free	Available coin
locked	Forzen coin
permissions	Permission
Account Trade List
Response

[
  {
    "symbol": "BNBBTC",
    "id": "fad2af9e942049b6adbda1a271f990c6",
    "orderId": "bb41e5663e124046bd9497a3f5692f39",
    "orderListId": -1,
    "price": "4.00000100", 
    "qty": "12.00000000", 
    "quoteQty": "48.000012", 
    "commission": "10.10000000", 
    "commissionAsset": "BNB", 
    "time": 1499865549590, 
    "isBuyer": true, 
    "isMaker": false, 
    "isBestMatch": true,
    "isSelfTrade": true,
    "clientOrderId": null
  }
]
GET /api/v3/myTrades
Permission: SPOT_ACCOUNT_READ

Weight(IP): 10

Get trades for a specific account and symbol,Only the transaction records in the past 1 month can be queried. If you want to view more transaction records, please use the export function on the web side, which supports exporting transaction records of the past 3 years at most.

Parameters:

Name	Type	Mandatory	Description
symbol	string	YES	
orderId	string	NO	order Id
startTime	long	NO	
endTime	long	NO	
limit	int	NO	Default 100; max 100;
recvWindow	long	NO	
timestamp	long	YES	
Response:

Name	Description
symbol	
id	deal id
orderId	order id
price	Price
qty	Quantity
quoteQty	Deal quantity
time	Deal time
commission	
commissionAsset	
time	trade time
isBuyerMaker	
isBestMatch	
isSelfTrade	isSelfTrade
clientOrderId	clientOrderId
Enable MX Deduct
Enable or disable MX deduct for spot commission fee

Request

post api/v3/mxDeduct/enable
Response

{
  "data":{
    "mxDeductEnable":true
  },
  "code":0,
  "msg":"success",
  "timestamp":1669109672280
} 
POST api/v3/mxDeduct/enable
Permission: SPOT_DEAL_WRITE

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
mxDeductEnable	boolean	yes	true:enable,false:disable
recvWindow	long	no	recvWindow
timestamp	long	yes	timestamp
signature	string	yes	signature
Response:

Name	Type	Description
mxDeductEnable	boolean	true:enable,false:disable
For Futures:Enjoy 10% off trading fees when you transfer MX into your futures account.
Query MX Deduct Status
Request

get api/v3/mxDeduct/enable
Response

{
  "data":{
    "mxDeductEnable":false
  },
  "code":0,
  "msg":"success",
  "timestamp":1669109672717
}
GET api/v3/mxDeduct/enable
Permission: SPOT_DEAL_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
recvWindow	long	no	recvWindow
timestamp	long	yes	timestamp
signature	string	yes	signature
Response:

Name	Type	Description
mxDeductEnable	boolean	true:enable,false:disable
Query Symbol Commission
request

get api/v3/tradeFee?symbol=MXUSDT&timestamp={{timestamp}}&signature={{signature}}
return

{
  "data":{
    "makerCommission":0.003000000000000000,
    "takerCommission":0.003000000000000000
  },
  "code":0,
  "msg":"success",
  "timestamp":1669109672717
}
HTTP请求

GET api/v3/tradeFee
Permission: SPOT_ACCOUNT_READ

Weight(IP): 20

request

Name	Type	Mandatory	Description
symbol	string	yes	symbol
recvWindow	long	no	recvWindow
timestamp	long	yes	timestamp
signature	string	yes	signature
return

Name	Type	Description
makerCommission	long	User Maker Commission
takerCommission	long	User Taker Commission
Wallet Endpoints
Query the currency information
Request

Get /api/v3/capital/config/getall
Response

[
  {
    "coin": "EOS",
    "Name": "EOS",
    "networkList": [
      {
          "coin": "EOS",
          "depositDesc": null,
          "depositEnable": true,
          "minConfirm": 0,
          "Name": "EOS",
          "network": "EOS",
          "withdrawEnable": false,
          "withdrawFee": "0.000100000000000000",
          "withdrawIntegerMultiple": null,
          "withdrawMax": "10000.000000000000000000",
          "withdrawMin": "0.001000000000000000",
          "sameAddress": false,
          "contract": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxbm9",
          "withdrawTips": "Both a MEMO and an Address are required.",
          "depositTips": "Both a MEMO and an Address are required.",
          "netWork": "EOS"
      },
      {
          "coin": "BTC",
          "depositDesc": null,
          "depositEnable": true,
          "minConfirm": 0,
          "Name": "BTC-BSC",
          "network": "BEP20(BSC)",
          "withdrawEnable": true,
          "withdrawFee": "0.000010000000000000",
          "withdrawIntegerMultiple": null,
          "withdrawMax": "100.000000000000000000",
          "withdrawMin": "0.000100000000000000",
          "sameAddress": false,
          "contract": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c",
          "withdrawTips": null,
          "depositTips": null,
          "network": "BTC"
      }
    ]
  },
]
GET /api/v3/capital/config/getall
Permission: SPOT_WITHDRAW_READ

Weight(IP): 10

Query currency details and the smart contract address

Parameters:

None

Response:

Name	Description
depositEnable	depositEnable
withdrawEnable	withdrawEnable
withdrawFee	withdrawFee
withdrawMax	Max withdraw amount
withdrawMin	Min withdraw amount
contract	coin contract
withdrawTips	withdrawTips
depositTips	depositTips
network	withdraw network(previous params,offline soon)
netWork	withdraw network(new params,for new withdraw endpoint)
Withdraw(new)
Request

post /api/v3/capital/withdraw?coin=EOS&address=zzqqqqqqqqqq&amount=10&network=EOS&memo=MX10086&timestamp={{timestamp}}&signature={{signature}}
Response

{
    "id":"7213fea8e94b4a5593d507237e5a555b"
}
POST /api/v3/capital/withdraw
Permission: SPOT_WITHDRAW_WRITE

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
coin	string	YES	coin
withdrawOrderId	string	NO	withdrawOrderId
netWork	string	NO	withdraw network
contractAddress	string	NO	coin contract address
address	string	YES	withdraw address
memo	string	NO	memo(If memo is required in the address, it must be passed in)
amount	string	YES	withdraw amount
remark	string	NO	remark
timestamp	string	YES	timestamp
signature	string	YES	signature
Can get netWork via endpoints Get /api/v3/capital/config/getall's response params networkList.

Response:

Name	Description
id	withdraw ID
Cancel withdraw
Request

delete /api/v3/capital/withdraw?id=ca7bd51895134fb5bd749f1cf875b8af&timestamp={{timestamp}}&signature={{signature}}
Response

{
    "id": "ca7bd51895134fb5bd749f1cf875b8af"
}
DELETE /api/v3/capital/withdraw
Permission: SPOT_WITHDRAW_W

Weight(IP): 1

Request

Name	Type	Mandatory	Description
id	string	Yes	withdraw id
Response

Name	Description
id	withdraw id
Deposit History(supporting network)
Request

get /api/v3/capital/deposit/hisrec?coin=EOS&timestamp={{timestamp}}&signature={{signature}}
Response

[
  {
        "amount": "50000",
        "coin": "EOS",
        "network": "EOS",
        "status": 5,
        "address": "0x20b7cf77db93d6ef1ab979c49142ec168427fdee",
        "txId": "01391d1c1397ef0a3cbb3c7f99a90846f7c8c2a8dddcdcf84f46b530dede203e1bc804",
        "insertTime": 1659513342000,
        "unlockConfirm": "10",
        "confirmTimes": "241",
        "memo": "xxyy1122"
  }
]
GET /api/v3/capital/deposit/hisrec
Permission: SPOT_WITHDRAW_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
coin	string	NO	coin
status	string	NO	status
startTime	string	NO	default: 7 days ago from current time
endTime	string	NO	default:current time
limit	string	NO	default:1000,max:1000
timestamp	string	YES	timestamp
signature	string	YES	signature
default return the records of the last 7 days.
Ensure that the default timestamp of 'startTime' and 'endTime' does not exceed 7 days.
can query 90 days data at most.
Response:

Name	Description
amount	deposit amount
coin	coin
network	deposit network
status	deposit status,1:SMALL,2:TIME_DELAY,3:LARGE_DELAY,
4:PENDING,5:SUCCESS,6:AUDITING,7:REJECTED
address	deposit adress
addressTag	addressTag
txId	txId
insertTime	insertTime
unlockConfirm	unlockConfirm
confirmTimes	confirmTimes
memo	memo
Withdraw History (supporting network)
Request

get /api/v3/capital/withdraw/history?coin=USDT&timestamp={{timestamp}}&signature={{signature}}
Response

[
  {
        "id": "bb17a2d452684f00a523c015d512a341",
        "txId": null,
        "coin": "EOS",
        "network": "EOS",
        "address": "zzqqqqqqqqqq",
        "amount": "10",
        "transferType": 0,
        "status": 3,
        "transactionFee": "0",
        "confirmNo": null,
        "applyTime": 1665300874000,
        "remark": "",
        "memo": "MX10086",
        "transHash": "0x0ced593b8b5adc9f600334d0d7335456a7ed772ea5547beda7ffc4f33a065c",
        "updateTime": 1712134082000,
        "coinId": "128f589271cb495b03e71e6323eb7be",
        "vcoinId": "af42c6414b9a46c8869ce30fd51660f"
  }
]
GET /api/v3/capital/withdraw/history
Permission: SPOT_WITHDRAW_READ

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
coin	string	NO	coin
status	string	NO	withdraw status
limit	string	NO	default:1000, max:1000
startTime	string	NO	default: 7 days ago from current time
endTime	string	NO	default:current time
timestamp	string	YES	timestamp
signature	string	YES	signature
default return the records of the last 7 days.
Ensure that the default timestamp of 'startTime' and 'endTime' does not exceed 7 days.
can query 90 days data at most.
Supported multiple network coins's withdraw history may not return the 'network' field.
Response:

Name	Description
address	withdraw address
amount	withdraw amount
applyTime	apply time
coin	coin
id	withdraw id
withdrawOrderId	withdrawOrderId
network	withdraw network
transferType	transferType, 0: outside transfer,1: inside transfer
status	withdraw status,1:APPLY,2:AUDITING,3:WAIT,4:PROCESSING,5:WAIT_PACKAGING,
6:WAIT_CONFIRM,7:SUCCESS,8:FAILED,9:CANCEL,10:MANUAL
transactionFee	transactionFee
confirmNo	confirmNo
txId	txId
remark	remark
memo	memo
transHash	transaction Hash
coinId	asset id
vcoinId	currency id
Generate deposit address (supporting network)
Request

post /api/v3/capital/deposit/address?coin=EOS&network=EOS&timestamp={{timestamp}}&signature={{signature}}
Response

[
  {
      "coin": "USDT",
      "network": "TRC20",
      "address": "TXobiKkdciupZrhdvZyTSSLjE8CmZAufS",
      "tag": null
  },
  {
     "coin": "EOS",
     "network": "EOS",
     "address": "zzqqqqqqqqqq",
     "memo": "MX10068"
  }
]
POST /api/v3/capital/deposit/address
Permission: SPOT_WITHDRAW_WRITE

Weight(IP): 1

Parameters:

Name	Type	Mandatory	Description
coin	string	YES	coin
network	string	YES	deposit network
timestamp	string	YES	timestamp
signature	string	YES	signature
Response:

Name	Description
address	deposit address
coin	coin
memo	memo
network	network
Deposit Address (supporting network)
Request

get /api/v3/capital/deposit/address?coin=USDT&timestamp={{timestamp}}&signature={{signature}}
Response

[
  {
      "coin": "USDT",
      "network": "TRC20",
      "address": "TXobiKkdciupZrhdvZyTSSLjE8CmZAufS",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "BEP20(BSC)",
      "address": "0xebe4804f7ecc22d5011c42e6ea1f2e6c891d89b",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "ERC20",
      "address": "0x3f4d1f43761b52fd594e5a77cd83cab6955e85b",
      "memo": null
  }
]
GET /api/v3/capital/deposit/address
Permission: SPOT_WITHDRAW_READ

Weight(IP): 10
 вот 1 часть инструкции запоминай дам вторую