Skip to content

Connect Binance

Binance, in the same book as your salary

A read-only key, and your trades, deposits and withdrawals arrive as transactions next to the rent, with a cost basis kept.

Read only, and refused if the key can trade or withdraw. How we check that is below.

Connections · Binance

The Binance card on the Connections screen and its drawer: what Orla reads, what it never does, and the read-only key it asks for. Nothing is saved until Binance has answered what the key may do, and a key with more than read rights is refused.

What lands in the book

Not a balance. The movements that stand behind it

A tracker shows today's value. That number answers nothing in January.

  • Spot fills arrive as a pair of legs, what left and what arrived, so a sale has a real price and not a guess.
  • Fees arrive as their own line, in the currency they were charged in.
  • Deposits and withdrawals arrive as transfers, and when the other side is a wallet you also connected, the two are joined into one move.
  • The first sync reaches back to 1 January of the previous calendar year, so two tax years are covered.
  • After that it keeps up hourly.

The key you give us

We ask Binance what your key can do, and refuse it if the answer is wrong

Promising read only is easy. This is what we do instead of promising.

Before the connection exists
The key is tried against Binance first; nothing is saved until it answers.
What we ask Binance
Binance publishes the restrictions on a key and we read them: a key that reports the right to trade or to withdraw is rejected.
If the answer is unclear
Refused. An answer without the flags we read counts as no answer: a venue that renamed them would otherwise pass every key as read only.
Where the secret lives
Encrypted at rest once it is accepted, and never returned by our API again, not to you and not to us.
If the key stops working
Sync stops after repeated auth failures, the space owner gets one message, and you replace the key in place.

Give the key read permission and nothing else, or the connection stops here.

The part that gets tax wrong

Moving your own coins is not a sale

Most tools book it as one anyway, and the bill is real.

  • A withdrawal to your own wallet is matched to the arrival on the other side by transaction hash.
  • Matched, the two legs become one internal move and no gain is calculated.
  • Unmatched, it is left out of the disposals rather than counted as a sale.

Questions

The questions people ask before pasting a key

Can Orla trade or withdraw with my Binance key?

No, and it is not a promise: a key that reports the right to trade or withdraw is rejected before the connection is created. Binance publishes the restrictions on a key and we read them. If the answer does not contain the flags we look for, the key is refused as well, because a venue that renamed them would otherwise pass everything as read only.

Does it import my trade history or just the balance?

Both, and the history is the point. Spot fills, deposits and withdrawals become transactions in the ledger, so the capital gains engine can work a cost basis out by lot. The first sync reaches back to 1 January of the previous calendar year, which covers the current tax year and the one before it as well.

Will moving coins from Binance to my own wallet look like a sale?

No. The withdrawal is matched to the arrival on the other side, by transaction hash where Binance gives one and by coin, amount and date where it does not, and the pair becomes one internal move. An unmatched withdrawal is left out of disposals rather than counted as a sale of any kind.

Other exchanges

Connect Binance, and see the year add up

Exchanges connect on every plan, the free one included. A plan counts the rows synced in a month, not the connections.

Bybit →
The same rows, with the key's permissions read before it is saved.
OKX →
Key, secret and passphrase, with the permission list read before any is saved.
Coinbase →
Fills, fees and transfers as transactions, rather than a balance that answers nothing when January comes.
Kraken →
Publishes no key permissions, so Orla asks the venue itself with two requests that cannot execute.
Hyperliquid →
No key at all: equity, deposits and daily results from a public address.

See it on your own books

Thirty minutes: we connect an account, drop a real bill in, and close a month together.