### POST /sapi/v1/giftcard/createCode Source: https://binance.github.io/binance-api-swagger/spot_api.yaml This API is for creating a Binance Code. To get started with, please make sure: - You have a Binance account - You have passed kyc - You have a sufficient balance in your Binance funding wallet - You need Enable Withdrawals for the API Key which requests this endpoint. Daily creation volume: 2 BTC / 24H Daily creation times: 200 Codes / 24H Weight(IP): 1 ```markdown ### Parameters - **token** (string, query, required): The coin type contained in the Binance Code - **amount** (number (double), query, required): The amount of the coin - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Code creation - **code** (string) (required) (example: "000000") - **message** (string) (required) (example: "success") - **data** (object) (required) - **referenceNo** (string) (required) (example: "0033002327977405") - **code** (string) (required) (example: "AOGANK3NB4GIT3C6") - **expiredTime** (integer (int64)) (required) (example: 1727417154000) - **success** (boolean) (required) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/giftcard/createCode?token=string&amount=0&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/asset/assetDetail Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Fetch details of assets supported on Binance. - Please get network and other deposit or withdraw details from `GET /sapi/v1/capital/config/getall`. Weight(IP): 1 ```markdown ### Parameters - **asset** (string, query, optional) (example: "BNB") - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Asset detail - **CTR** (object) (required) - **minWithdrawAmount** (string) (required) (example: "70.00000000") - **depositStatus** (boolean) (required): deposit status (false if ALL of networks' are false) (example: false) - **withdrawFee** (integer (int64)) (required) (example: 35) - **withdrawStatus** (boolean) (required): withdrawStatus status (false if ALL of networks' are false) - **depositTip** (string) (required) (example: "Delisted, Deposit Suspended") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/asset/assetDetail?asset=BNB&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### POST /sapi/v1/giftcard/buyCode Source: https://binance.github.io/binance-api-swagger/spot_api.yaml This API is for buying a fixed-value Binance Code, which means your Binance Code will be redeemable to a token that is different to the token that you are paying in. If the token you’re paying and the redeemable token are the same, please use the Create Binance Code endpoint. You can use supported crypto currency or fiat token as baseToken to buy Binance Code that is redeemable to your chosen faceToken. Once successfully purchased, the amount of baseToken would be deducted from your funding wallet. To get started with, please make sure: - You have a Binance account - You have passed kyc - You have a sufficient balance in your Binance funding wallet - You need Enable Withdrawals for the API Key which requests this endpoint. Daily creation volume: 2 BTC / 24H Daily creation times: 200 Codes / 24H Weight(IP): 1 ```markdown ### Parameters - **baseToken** (string, query, required): The token you want to pay, example BUSD - **faceToken** (string, query, required): The token you want to buy, example BNB. If faceToken = baseToken, it's the same as createCode endpoint. - **baseTokenAmount** (number (double), query, required): The base token asset quantity, example 1.002 - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Code creation - **code** (string) (required) (example: "000000") - **message** (string) (required) (example: "success") - **data** (object) (required) - **referenceNo** (string) (required) (example: "0033002327977405") - **code** (string) (required) (example: "AOGANK3NB4GIT3C6") - **expiredTime** (integer (int64)) (required) (example: 1727417154000) - **success** (boolean) (required) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/giftcard/buyCode?baseToken=string&faceToken=string&baseTokenAmount=0&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/loan/vip/request/data Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get Application Status Weight(UID): 400 ```markdown ### Parameters - **current** (integer (int32), query, optional): Current querying page. Start from 1. Default:1 (example: 1) - **limit** (integer (int32), query, optional): Default 500; max 1000. (example: 5) - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Application Status - **total** (integer) (required) (example: 1) - **rows** (array (object)) (required) Array items: - **loanAccountId** (string) (required) (example: "12345678") - **orderId** (string) (required) (example: "12345678") - **requestId** (string) (required) (example: "12345678") - **loanCoin** (string) (required) (example: "BTC") - **loanAmount** (string) (required) (example: "100.5") - **collateralAccountId** (string) (required) (example: "12345678,12345678,12345678") - **collateralCoin** (string) (required) (example: "BUSD,USDT,ETH") - **loanTerm** (integer) (required) (example: "30") - **status** (integer) (required) (example: "Repaid") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/loan/vip/request/data?current=1&limit=5&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### POST /sapi/v1/simple-earn/flexible/redeem Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Weight(IP): 1 Rate Limit: 1/3s per account ```markdown ### Parameters - **productId** (string, query, required) - **redeemAll** (boolean, query, optional): true or false, default to false - **amount** (number (double), query, optional): if redeemAll is false, amount is mandatory - **destAccount** (string, query, optional): SPOT,FUND,ALL, default SPOT - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Redeem Flexible Product - **redeemId** (integer (int64)) (required) (example: 40607) - **success** (boolean) (required) (example: true) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/simple-earn/flexible/redeem?productId=string&redeemAll=true&amount=0&destAccount=string&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/portfolio/account Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get the account info 'Weight(IP): 1' ```markdown ### Parameters - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Portfolio account. - **uniMMR** (string) (required): Classic Portfolio margin account maintenance margin rate (example: "1.87987800") - **accountEquity** (string) (required): Account equity, unit is USD (example: "122607.35137903") - **actualEquity** (string) (required): Actual equity, unit is USD (example: "142607.35137903") - **accountMaintMargin** (string) (required): Classic Portfolio margin account maintenance margin, unit is USD (example: "23.72469206") - **accountStatus** (string) (required): Classic Portfolio margin account status:"NORMAL", "MARGIN_CALL", "SUPPLY_MARGIN", "REDUCE_ONLY", "ACTIVE_LIQUIDATION", "FORCE_LIQUIDATION", "BANKRUPTED" (example: "NORMAL") - **accountType** (string) (required): PM_1 for classic PM, PM_2 for PM (example: "PM_1") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/portfolio/account?recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/lending/project/list Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Weight(IP): 1 ```markdown ### Parameters - **asset** (string, query, optional) (example: "BNB") - **type** (string (ACTIVITY|CUSTOMIZED_FIXED), query, required) - **status** (string (ALL|SUBSCRIBABLE|UNSUBSCRIBABLE), query, optional): Default `ALL` - **isSortAsc** (boolean, query, optional): default "true" - **sortBy** (string (START_TIME|LOT_SIZE|INTEREST_RATE|DURATION), query, optional): Default `START_TIME` - **current** (integer (int32), query, optional): Current querying page. Start from 1. Default:1 (example: 1) - **size** (integer (int32), query, optional): Default:10 Max:100 (example: 100) - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - List of fixed projects - Array of object - **asset** (string) (required) (example: "USDT") - **displayPriority** (integer (int64)) (required) (example: 1) - **duration** (integer (int64)) (required) (example: 90) - **interestPerLot** (string) (required) (example: "1.35810000") - **interestRate** (string) (required) (example: "0.05510000") - **lotSize** (string) (required) (example: "100.00000000") - **lotsLowLimit** (integer (int64)) (required) (example: 1) - **lotsPurchased** (integer (int64)) (required) (example: 74155) - **lotsUpLimit** (integer (int64)) (required) (example: 80000) - **maxLotsPerUser** (integer (int64)) (required) (example: 2000) - **needKyc** (boolean) (required) - **projectId** (string) (required) (example: "CUSDT90DAYSS001") - **projectName** (string) (required) (example: "USDT") - **status** (string) (required) (example: "PURCHASING") - **type** (string) (required) (example: "CUSTOMIZED_FIXED") - **withAreaLimitation** (boolean) (required) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/lending/project/list?asset=BNB&type=ACTIVITY&status=ALL&isSortAsc=true&sortBy=START_TIME¤t=1&size=100&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### POST /sapi/v1/simple-earn/flexible/subscribe Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Weight(IP): 1 Rate Limit: 1/3s per account ```markdown ### Parameters - **productId** (string, query, required) - **amount** (number (double), query, required) - **autoSubscribe** (boolean, query, optional): true or false, default true. - **sourceAccount** (string, query, optional): SPOT,FUND,ALL, default SPOT - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Flexible Product Subscription Response - **purchaseId** (integer (int64)) (required) (example: 40607) - **success** (boolean) (required) (example: true) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/simple-earn/flexible/subscribe?productId=string&amount=0&autoSubscribe=true&sourceAccount=string&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /api/v3/trades Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get recent trades. Weight(IP): 10 ```markdown ### Parameters - **symbol** (string, query, required): Trading symbol, e.g. BNBUSDT (example: "BNBUSDT") - **limit** (integer (int32), query, optional): Default 500; max 1000. (example: 5) ### Responses #### 200 - Trade list - Array of trade #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/api/v3/trades?symbol=BNBUSDT&limit=5" ``` ``` -------------------------------- ### POST /sapi/v1/algo/futures/newOrderVp Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Send in a VP new order. Only support on USDⓈ-M Contracts. - You need to enable `Futures Trading Permission` for the api key which requests this endpoint. - Base URL: https://api.binance.com - Total Algo open orders max allowed: 10 orders. - Leverage of symbols and position mode will be the same as your futures account settings. You can set up through the trading page or fapi. - Receiving "success": true does not mean that your order will be executed. Please use the query order endpoints(GET sapi/v1/algo/futures/openOrders or GET sapi/v1/algo/futures/historicalOrders) to check the order status. For example: Your futures balance is insufficient, or open position with reduce only or position side is inconsistent with your own setting. In these cases you will receive "success": true, but the order status will be expired after we check it. Weight(UID): 3000 ```markdown ### Parameters - **symbol** (string, query, required): Trading symbol, e.g. BNBUSDT (example: "BNBUSDT") - **side** (string (SELL|BUY), query, required) (example: "SELL") - **positionSide** (string (BOTH|LONG|SHORT), query, optional): Default BOTH for One-way Mode ; LONG or SHORT for Hedge Mode. It must be sent in Hedge Mode. (example: "BOTH") - **quantity** (number (double), query, required): Quantity of base asset; The notional (quantity * mark price(base asset)) must be more than the equivalent of 10,000 USDT and less than the equivalent of 1,000,000 USDT - **urgency** (string (LOW|MEDIUM|HIGH), query, required): Represent the relative speed of the current execution; ENUM: LOW, MEDIUM, HIGH (example: "LOW") - **clientAlgoId** (string, query, optional): A unique id among Algo orders (length should be 32 characters), If it is not sent, we will give default value (example: "00358ce6a268403398bd34eaa36dffe7") - **reduceOnly** (boolean, query, optional): 'true' or 'false'. Default 'false'; Cannot be sent in Hedge Mode; Cannot be sent when you open a position - **limitPrice** (number (double), query, optional): Limit price of the order; If it is not sent, will place order by market price by default - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Volume Participation(VP) Order - **clientAlgoId** (string) (required) (example: "00358ce6a268403398bd34eaa36dffe7") - **success** (boolean) (required) (example: true) - **code** (integer (int64)) (required) (example: 0) - **msg** (string) (required) (example: "OK") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/algo/futures/newOrderVp?symbol=BNBUSDT&side=SELL&positionSide=BOTH&quantity=0&urgency=LOW&clientAlgoId=00358ce6a268403398bd34eaa36dffe7&reduceOnly=true&limitPrice=0&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/loan/vip/request/interestRate Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get borrow interest rate. Weight(UID): 400 ```markdown ### Parameters - **loanCoin** (string, query, optional): Max 10 assets, Multiple split by "," (example: "BUSD") - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Borrow interest rate - Array of object - **asset** (string) (required) (example: "BUSD") - **flexibleDailyInterestRate** (string) (required) (example: "0.001503") - **flexibleYearlyInterestRate** (string) (required) (example: "0.548595") - **time** (integer (int64)) (required) (example: 1577233578000) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/loan/vip/request/interestRate?loanCoin=BUSD&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/lending/auto-invest/plan/list Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Query plan lists Weight(IP): 1 ```markdown ### Parameters - **planType** (string, query, required) - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Plan result - **planValueInUSD** (string) (required) (example: "123") - **planValueInBTC** (string) (required) (example: "0.1") - **pnlInUSD** (string) (required) (example: "120") - **roi** (string) (required) (example: "2.3") - **plan** (array (object)) (required) Array items: - **planId** (integer) (required) (example: 12345) - **planType** (string) (required) (example: "SINGLE") - **editAllowed** (string) (required) (example: "true") - **creationDateTime** (integer (int64)) (required) (example: 1648378800000) - **firstExecutionDateTime** (integer (int64)) (required) (example: 1648378800000) - **nextExecutionDateTime** (integer (int64)) (required) (example: 1648378800000) - **status** (string) (required) (example: "ONGOING") - **lastUpdatedDateTime** (integer (int64)) (required) (example: 1648378800000) - **targetAsset** (string) (required) (example: "BTC") - **totalTargetAmount** (string) (required) (example: "0.111") - **sourceAsset** (string) (required) (example: "BUSD") - **totalInvestedInUSD** (string) (required) (example: "4.555") - **subscriptionAmount** (string) (required) (example: "0.1") - **subscriptionCycle** (string) (required) (example: "WEEKLY") - **subscriptionStartDay** (string) (required) (example: "1") - **subscriptionStartWeekday** (string) (required) (example: "MON") - **subscriptionStartTime** (string) (required) (example: "1") - **sourceWallet** (string) (required) (example: "SPOT_WALLET") - **flexibleAllowedToUse** (string) (required) (example: "false") - **planValueInUSD** (string) (required) (example: "101.2") - **pnlInUSD** (string) (required) (example: "101.2") - **roi** (string) (required) (example: "1.02") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/lending/auto-invest/plan/list?planType=string&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /sapi/v1/loan/vip/collateral/data Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get collateral asset data. Weight(IP): 400 ```markdown ### Parameters - **collateralCoin** (string, query, optional): Coin used as collateral (example: "BNB") - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Collateral Asset Data - **rows** (array (object)) (required) Array items: - **collateralCoin** (string) (required) (example: "BUSD") - **_1stCollateralRatio** (string) (required) (example: "100%") - **_1stCollateralRange** (string) (required) (example: "1-10000000") - **_2ndCollateralRatio** (string) (required) (example: "80%") - **_2ndCollateralRange** (string) (required) (example: "10000000-100000000") - **_3rdCollateralRatio** (string) (required) (example: "60%") - **_3rdCollateralRange** (string) (required) (example: "100000000-1000000000") - **_4thCollateralRatio** (string) (required) (example: "0%") - **_4thCollateralRange** (string) (required) (example: ">10000000000") - **total** (integer (int32)) (required) (example: 1) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/sapi/v1/loan/vip/collateral/data?collateralCoin=BNB&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /api/v3/account/commission Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get current account commission rates. Weight: 20 ```markdown ### Parameters - **symbol** (string, query, required): Trading symbol, e.g. BNBUSDT (example: "BNBUSDT") - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Current account commission rates. - **symbol** (string) (required) (example: "BTCUSDT") - **standardCommission** (object) (required): Standard commission rates on trades from the order. - **maker** (string) (required) (example: "0.00000010") - **taker** (string) (required) (example: "0.00000020") - **buyer** (string) (required) (example: "0.00000030") - **seller** (string) (required) (example: "0.00000040") - **taxCommission** (object) (required): Tax commission rates for trades from the order. - **discount** (object) (required): Discount commission when paying in BNB. - **enabledForAccount** (boolean) (example: true) - **enabledForSymbol** (boolean) (example: true) - **discountAsset** (string) (example: "BNB") - **discount** (string): Standard commission is reduced by this rate when paying commission in BNB. (example: "0.25000000") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/api/v3/account/commission?symbol=BNBUSDT×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /api/v3/exchangeInfo Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Current exchange trading rules and symbol information - If any symbol provided in either symbol or symbols do not exist, the endpoint will throw an error. - All parameters are optional. - permissions can support single or multiple values (e.g. SPOT, ["MARGIN","LEVERAGED"]) - If permissions parameter not provided, the default values will be ["SPOT","MARGIN","LEVERAGED"]. - To display all permissions you need to specify them explicitly. (e.g. SPOT, MARGIN,...) Examples of Symbol Permissions Interpretation from the Response: - [["A","B"]] means you may place an order if your account has either permission "A" or permission "B". - [["A"],["B"]] means you can place an order if your account has permission "A" and permission "B". - [["A"],["B","C"]] means you can place an order if your account has permission "A" and permission "B" or permission "C". (Inclusive or is applied here, not exclusive or, so your account may have both permission "B" and permission "C".) Weight(IP): 10 ```markdown ### Parameters - **symbol** (string, query, optional): Trading symbol, e.g. BNBUSDT (example: "BNBUSDT") - **symbols** (string, query, optional) (example: "[\"BTCUSDT\",\"BNBBTC\"]") - **permissions** (string, query, optional) (example: "'SPOT' or ['MARGIN','LEVERAGED']") ### Responses #### 200 - Current exchange trading rules and symbol information - **timezone** (string) (required) (example: "UTC") - **serverTime** (integer (int64)) (required) (example: 1592882214236) - **rateLimits** (array (object)) (required) Array items: - **rateLimitType** (string) (required) (example: "REQUEST_WEIGHT") - **interval** (string) (required) (example: "MINUTE") - **intervalNum** (integer (int32)) (required) (example: 1) - **limit** (integer (int32)) (required) (example: 1200) - **exchangeFilters** (array (object)) (required) - **symbols** (array (object)) (required) Array items: - **symbol** (string) (required) (example: "ETHBTC") - **status** (string) (required) (example: "TRADING") - **baseAsset** (string) (required) (example: "ETH") - **baseAssetPrecision** (integer (int32)) (required) (example: 8) - **quoteAsset** (string) (required) (example: "BTC") - **quoteAssetPrecision** (integer (int32)) (required) (example: 8) - **baseCommissionPrecision** (integer (int32)) (required) (example: 8) - **quoteCommissionPrecision** (integer (int32)) (required) (example: 8) - **orderTypes** (array (string)) (required) - **icebergAllowed** (boolean) (required) (example: true) - **ocoAllowed** (boolean) (required) (example: true) - **otoAllowed** (boolean) (required) (example: false) - **quoteOrderQtyMarketAllowed** (boolean) (required) (example: true) - **allowTrailingStop** (boolean) (required) (example: false) - **cancelReplaceAllowed** (boolean) (required) (example: true) - **isSpotTradingAllowed** (boolean) (required) (example: true) - **isMarginTradingAllowed** (boolean) (required) (example: true) - **filters** (array (object)) (required) Array items: - **filterType** (string) (required) (example: "PRICE_FILTER") - **minPrice** (string) (required) (example: "0.00000100") - **maxPrice** (string) (required) (example: "100000.00000000") - **tickSize** (string) (required) (example: "0.00000100") - **permissions** (array (string)) (required) - **permissionSets** (array (array (string))) (required) - **defaultSelfTradePreventionMode** (string) (required) (example: "NONE") - **allowedSelfTradePreventionModes** (array (string)) (required) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBUSDT&symbols=["BTCUSDT","BNBBTC"]&permissions='SPOT' or ['MARGIN','LEVERAGED']" ``` ``` -------------------------------- ### POST /sapi/v1/lending/customizedFixed/purchase Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Weight(IP): 1 ```markdown ### Parameters - **projectId** (string, query, required) - **lot** (string, query, required) - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Generated Purchase Id - **purchaseId** (string) (required) (example: "18356") #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/lending/customizedFixed/purchase?projectId=string&lot=string&recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### GET /api/v3/account Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Get current account information. Weight(IP): 20 ```markdown ### Parameters - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Account details **account** - **makerCommission** (integer (int64)) (required) (example: 15) - **takerCommission** (integer (int64)) (required) (example: 15) - **buyerCommission** (integer (int64)) (required) (example: 0) - **sellerCommission** (integer (int64)) (required) (example: 0) - **commissionRates** (object) (required) - **maker** (string) (required) (example: "0.00150000") - **taker** (string) (required) (example: "0.00150000") - **buyer** (string) (required) (example: "0.00000000") - **seller** (string) (required) (example: "0.00000000") - **canTrade** (boolean) (required) - **canWithdraw** (boolean) (required) - **canDeposit** (boolean) (required) - **brokered** (boolean) (required) (example: false) - **requireSelfTradePrevention** (boolean) (required) (example: false) - **preventSor** (boolean) (required) (example: false) - **updateTime** (integer (int64)) (required) (example: 123456789) - **accountType** (string) (required) (example: "SPOT") - **balances** (array (object)) (required) Array items: - **asset** (string) (required) (example: "BTC") - **free** (string) (required) (example: "4723846.89208129") - **locked** (string) (required) (example: "0.00000000") - **permissions** (array (string)) (required) - **uid** (integer (int64)) (required) (example: 354937868) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X GET "https://api.binance.com/api/v3/account?recvWindow=5000×tamp=0&signature=string" ``` ``` -------------------------------- ### POST /sapi/v1/lending/auto-invest/plan/add Source: https://binance.github.io/binance-api-swagger/spot_api.yaml Post an investment plan creation Weight(IP): 1 ```markdown ### Parameters - **sourceType** (string (MAIN_SITE|TR), query, required) (example: "MAIN_SITE") - **requestId** (string, query, optional) - **planType** (string (SINGLE|PORTFOLIO|INDEX), query, required) (example: "SINGLE") - **IndexId** (integer (int64), query, optional) - **subscriptionAmount** (number (float), query, required) - **subscriptionCycle** (string (H1|H4|H8|H12|WEEKLY|DAILY|MONTHLY|BI_WEEKLY), query, required) - **subscriptionStartDay** (integer, query, optional) - **subscriptionStartWeekday** (string (MON|TUE|WED|THU|FRI|SAT|SUN), query, optional) - **subscriptionStartTime** (integer, query, required) - **sourceAsset** (string, query, required) (example: "USDT") - **flexibleAllowedToUse** (boolean, query, optional) (example: true) - **details** (array (object), query, required) - **recvWindow** (integer (int64), query, optional): The value cannot be greater than 60000 (example: 5000) - **timestamp** (integer (int64), query, required): UTC timestamp in ms - **signature** (string, query, required): Signature ### Responses #### 200 - Plan result - **planId** (integer) (required) (example: 12345) - **nextExecutionDateTime** (integer (int64)) (required) (example: 1648378800000) #### 400 - Bad Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") #### 401 - Unauthorized Request **error** - **code** (integer (int64)) (required): Error code - **msg** (string) (required): Error message (example: "error message") ### Example Usage ```bash curl -X POST "https://api.binance.com/sapi/v1/lending/auto-invest/plan/add?sourceType=MAIN_SITE&requestId=string&planType=SINGLE&IndexId=0&subscriptionAmount=0&subscriptionCycle=H1&subscriptionStartDay=0&subscriptionStartWeekday=MON&subscriptionStartTime=0&sourceAsset=USDT&flexibleAllowedToUse=true&details=item1,item2&recvWindow=5000×tamp=0&signature=string" ``` ```