Binance · USDⓈ-M futures
Sync your Binance USDⓈ-M perpetual futures trades and funding with a read-only API key.
New and not yet tested against a live Binance account. It follows Binance's developer documentation; if something differs on your screen, tell us with Support in the Settings menu on the left.
Steps
- 1In Binance open Profile → API Management and click Create API → System generated. Name it, for example Tradeopath.
- 2Leave only Enable Reading ticked. Do not enable Futures, Spot & Margin Trading, Withdrawals, Internal Transfer or Universal Transfer.
- 3Copy the API key and the secret straight away; Binance shows the secret once.
- 4In Tradeopath open Connections, click Add connection and pick Binance. Paste the key and the secret, then Connect. Tradeopath asks Binance what the key may do and refuses it if it can trade, withdraw or transfer.
- 5Your account appears in your journal by itself within a couple of minutes, named like BINANCE-UM-<id>. The dashboard then asks once what kind of account each one is (personal, prop or demo).
Good to know
- Only USDⓈ-M perpetual futures (BTCUSDT and the like, margined in USDT or USDC) are synced. COIN-M futures and spot are not supported yet.
- Region: Binance blocks some countries, for example the US. The check happens at Binance, from the address of Tradeopath's servers, not from your computer. If Binance refuses that location, saving the key or the sync shows a "restricted location" error. Nothing is wrong with your key; the sync retries every ten minutes and works once the server is served.
- Trades are checked about every 75 seconds. When you connect, and after each restart of the sync service, the last 3 months (the most Binance serves) are read. Binance only returns fills when asked per symbol, so Tradeopath finds the symbols you traded from your income history first.
- A trade is imported once its position is closed, because the funding you paid or received while it was open belongs to it. Open positions show up when they close.
- Funding is stored as the trade's Funding (the swap column): a positive number is funding you paid, a negative one is funding you received. It is included in the fees, so net P&L already reflects it.
- Commissions are converted to US dollars. A commission paid in BNB is converted with the hourly BNBUSDT price at the time of the fill. Dollar stablecoins (USDT, USDC, FDUSD, BUSD, USD1) count as 1 dollar each.
- The trading day for a Binance account ends at 00:00 UTC.
- Hedge mode (long and short on one symbol at once) is not modelled: opposite positions are netted per symbol.
- Tradeopath re-checks the key now and then. If a key later gains trading, withdrawal or transfer rights, the connection stops with an error until you replace it with a read-only key.
- A rejected key or secret, or an IP restriction that does not include our server, shows an error on the connection. A read-only key needs no IP restriction.
- To stop syncing, click Disconnect on the Connections page and delete the API key in Binance.