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.

What lands in the book

Not a balance. The movements 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, which covers this tax year and the one before it
  • 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 existsNot afterThe key is tried against Binance first. Nothing is saved until it answers
What we ask BinanceTheir own answer, not our guessBinance publishes the restrictions on a key. We read them, and a key that reports the right to trade or to withdraw is rejected outright
If the answer is unclearThe important halfRefused. An answer without the flags we read is treated as no answer, because a venue that renamed them would otherwise pass every key as read only
Where the secret livesAfter it is acceptedEncrypted at rest, and never returned by our API again, not to you and not to us
If the key stops workingRotation and expirySync stops after repeated auth failures, the space owner gets one message, and you replace the key in place

Give the key permission to read, and nothing else. If you give it more, this page is where the connection stops.

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 where the venue gives one
  • Matched, the two legs become one internal move and no gain is calculated
  • Unmatched, it is left out of disposals rather than counted as a sale: an unknown address is more often your own wallet

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.
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.

Didn't find your answer? [email protected]

Read next: how crypto works in the ledger, capital gains and the tax year, what getting paid in crypto really costs.

Start

Connect Binance, and see the year add up.

Connecting an exchange is on the paid plans; the free plan holds the book, manual accounts and imports.