Binance Derivatives-trading-usds-futures Skill

Derivatives-trading-usds-futures request on Binance using authenticated API endpoints. Requires API key and secret key for certain endpoints. Return the result in JSON format.

Quick Reference

Parameters

Common Parameters

• recvWindow: (e.g., 5000)
• symbol:
• startTime: Timestamp in ms (e.g., 1623319461670)
• endTime: Timestamp in ms (e.g., 1641782889000)
• downloadId: get by download id api (e.g., 1)
• incomeType: TRANSFER, WELCOME_BONUS, REALIZED_PNL, FUNDING_FEE, COMMISSION, INSURANCE_CLEAR, REFERRAL_KICKBACK, COMMISSION_REBATE, API_REBATE, CONTEST_REWARD, CROSS_COLLATERAL_TRANSFER, OPTIONS_PREMIUM_FEE, OPTIONS_SETTLE_PROFIT, INTERNAL_TRANSFER, AUTO_EXCHANGE, DELIVERED_SETTELMENT, COIN_SWAP_DEPOSIT, COIN_SWAP_WITHDRAW, POSITION_LIMIT_INCREASE_FEE, STRATEGY_UMFUTURES_TRANSFER，FEE_RETURN，BFUSD_REWARD
• startTime: (e.g., 1623319461670)
• endTime: (e.g., 1641782889000)
• page:
• limit: Default 100; max 1000 (e.g., 100)
• feeBurn: "true": Fee Discount On; "false": Fee Discount Off
• symbol:
• quoteId: (e.g., 1)
• fromAsset: User spends coin
• toAsset: User receives coin
• orderId: Either orderId or quoteId is required (e.g., 1)
• quoteId: Either orderId or quoteId is required (e.g., 1)
• fromAsset:
• toAsset:
• fromAmount: When specified, it is the amount you will be debited after the conversion (e.g., 1.0)
• toAmount: When specified, it is the amount you will be credited after the conversion (e.g., 1.0)
• validTime: 10s, default 10s (e.g., 10s)
• pair:
• limit: Default 30,Max 500 (e.g., 30)
• fromId: ID to get aggregate trades from INCLUSIVE. (e.g., 1)
• asset:
• orderId: (e.g., 1)
• countdownTime: countdown time, 1000 for 1 second. 0 to cancel the timer
• algoId: (e.g., 1)
• clientAlgoId: (e.g., 1)
• orderIdList: max length 10 e.g. [1234567,2345678]
• origClientOrderIdList: max length 10 e.g. ["my_id_1","my_id_2"], encode the double quotes. No space after comma.
• origClientOrderId: (e.g., 1)
• leverage: target initial leverage: int from 1 to 125
• multiAssetsMargin: "true": Multi-Assets Mode; "false": Single-Asset Mode
• dualSidePosition: "true": Hedge Mode; "false": One-way Mode
• algoType:
• type: 1: Add position margin，2: Reduce position margin
• amount: (e.g., 1.0)
• type:
• batchOrders: order list. Max 5 orders
• quantity: Order quantity, cannot be sent with closePosition=true (e.g., 1.0)
• price: (e.g., 1.0)
• algoType: Only support CONDITIONAL
• quantity: (e.g., 1.0)
• price: (e.g., 1.0)
• triggerPrice: (e.g., 1.0)
• closePosition: true, false；Close-All，used with STOP_MARKET or TAKE_PROFIT_MARKET.
• priceProtect: "TRUE" or "FALSE", default "FALSE". Used with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders.
• reduceOnly: "true" or "false". default "false". Cannot be sent in Hedge Mode
• activatePrice: Used with TRAILING_STOP_MARKET orders, default as the latest price(supporting different workingType) (e.g., 1.0)
• callbackRate: Used with TRAILING_STOP_MARKET orders, min 0.1, max 5 where 1 for 1% (e.g., 1.0)
• goodTillDate: order cancel time for timeInForce GTD, mandatory when timeInforce set to GTD; order the timestamp only retains second-level precision, ms part will be ignored; The goodTillDate timestamp must be greater than the current time plus 600 seconds and smaller than 253402300799000
• newClientOrderId: A unique id among open orders. Automatically generated if not sent. Can only be string following the rule: ^[\.A-Z\:/a-z0-9_-]{1,36}$ (e.g., 1)
• stopPrice: Used with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders. (e.g., 1.0)
• activationPrice: Used with TRAILING_STOP_MARKET orders, default as the latest price(supporting different workingType) (e.g., 1.0)
• batchOrders: order list. Max 5 orders

Enums

• contractType: PERPETUAL | CURRENT_MONTH | NEXT_MONTH | CURRENT_QUARTER | NEXT_QUARTER | PERPETUAL_DELIVERING
• period: 5m | 15m | 30m | 1h | 2h | 4h | 6h | 12h | 1d
• interval: 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
• marginType: ISOLATED | CROSSED
• positionSide: BOTH | LONG | SHORT
• side: BUY | SELL
• priceMatch: NONE | OPPONENT | OPPONENT_5 | OPPONENT_10 | OPPONENT_20 | QUEUE | QUEUE_5 | QUEUE_10 | QUEUE_20
• timeInForce: GTC | IOC | FOK | GTX | GTD | RPI
• workingType: MARK_PRICE | CONTRACT_PRICE
• newOrderRespType: ACK | RESULT
• selfTradePreventionMode: EXPIRE_TAKER | EXPIRE_BOTH | EXPIRE_MAKER
• autoCloseType: LIQUIDATION | ADL

Authentication

For endpoints that require authentication, you will need to provide Binance API credentials. Required credentials:

• apiKey: Your Binance API key (for header)
• secretKey: Your Binance API secret (for signing)

Base URLs:

• Mainnet: https://fapi.binance.com
• Testnet: https://demo-fapi.binance.com

Security

Share Credentials

Users can provide Binance API credentials in different ways. The agent will try to retrieve automatically with the two first ways the credentials, but users can also explicitly tell the agent that they have set the credentials or stored them in a .env file, and the agent should re-read that file when they do. The agent can also make http requests with the two first methods without user confirmation.

1. Environment variables

Search for the following specific variables only (never dump the full environment):

Authorized environment variables

• Mainnet: BINANCE_API_KEY and BINANCE_SECRET_KEY
• Testnet: BINANCE_TESTNET_API_KEY and BINANCE_TESTNET_SECRET_KEY