Exchange · API · CSV
BtcBox taxes, API plus a statement.
BtcBox’s API returns your balances, but not your trade history. Connect a read-only key for those, and bring trades in from a statement.
- Read-only
- 8 country reports
- Free to start
- From
- BtcBox
- To
- HashBooks ledger
- Method
- Read-only API key
- Access
- View only. No trading, no withdrawals
- Brings in
- Fees
- Report
- Form 8949 SA108 Schedule VDA myTax capital gains Schedule 3 Anlage SO Form CG1 IRAS income summary
- Keys
- AES-256-GCM, deleted on disconnect
Every row keeps its original record
Good to know
BtcBox specifics.
- BtcBox’s API has no trade-history endpoint that HashBooks can read, so trades must come from a file. Without them your gains can’t be worked out.
- HashBooks prepares your report for the country where you file, not where BtcBox is based, so gains on BtcBox follow your own country’s rules.
How to connect
Bring BtcBox in.
Pick the method that suits you — both land in the same ledger. Stuck? See connecting accounts in the help centre.
- Sign in to BtcBox and open its API management page.
- Create a new API key and enable read (view-only) permission only. Leave trading and withdrawals switched off.
- In HashBooks, choose BtcBox under Integrations and paste the API key and secret.
- HashBooks syncs your full history and keeps it up to date.
- Download your trade, deposit and withdrawal history from BtcBox.
- Copy the rows into the HashBooks CSV / Excel template: date, type, what you sent and received, the fee, and any TDS.
- Upload it in HashBooks, check the preview, then confirm. Uploading the same file twice never double-counts.
Taxed or not
BtcBox activity, taxed or not.
Whether each BtcBox move creates tax depends on where you file. This follows the country at the top of the page.
| On BtcBox | Taxable in United States? | How |
|---|---|---|
| Selling for cash | Yes | Capital gain or loss; short- or long-term by holding period. |
| Swapping one coin for another | Yes | A disposal of the coin you give up, at market value. |
| Moving to your own wallet | No | Moving between your own wallets and accounts. |
| Buying crypto | No | Buying with dollars sets your cost basis. |
| On BtcBox | Taxable in United Kingdom? | How |
|---|---|---|
| Selling for cash | Yes | Capital Gains Tax above the £3,000 annual exempt amount. |
| Swapping one coin for another | Yes | A disposal at market value. |
| Moving to your own wallet | No | Moving between your own wallets. |
| Buying crypto | No | Buying with pounds adds to your Section 104 pool. |
| On BtcBox | Taxable in India? | How |
|---|---|---|
| Selling for cash | Yes | 30% plus 4% cess on the gain; 1% TDS on Indian exchanges. |
| Swapping one coin for another | Yes | A transfer of the coin you give up, taxed at 30% plus cess; TDS applies on both legs. |
| Moving to your own wallet | No | Moving between your own wallets and exchanges. |
| Buying crypto | No | Buying with rupees sets your cost of acquisition. |
What comes across
What HashBooks reads from BtcBox.
- Fees
Your country
What your BtcBox activity means at tax time.
Pick where you file and the rules below follow. Each one has a longer write-up in the HashBooks help centre.
United States · Form 8949
- Selling, swapping or spending what you hold on BtcBox. Selling, swapping or spending crypto is a capital gain or loss: short-term at 10–37% if held a year or less, 0, 15 or 20% if held longer. More on BtcBox in United States
- Moving coins to or from BtcBox. Moving crypto between your own wallets and accounts isn’t taxable. More on BtcBox in United States
- Cost basis. Since 1 January 2025 cost basis is tracked per wallet or exchange; HashBooks uses FIFO, lot by lot. More on BtcBox in United States
Full rules: the United States crypto tax guide in the help centre, or the United States overview.
United Kingdom · SA108
- Selling, swapping or spending what you hold on BtcBox. Selling, swapping or spending crypto is a disposal for Capital Gains Tax: gains above the £3,000 annual exempt amount are taxed at 18% or 24%. More on BtcBox in United Kingdom
- Moving coins to or from BtcBox. Moving crypto between your own wallets isn’t a disposal. More on BtcBox in United Kingdom
- Cost basis. Disposals match same-day buys, then buys in the next 30 days, then the Section 104 pool. More on BtcBox in United Kingdom
Full rules: the United Kingdom crypto tax guide in the help centre, or the United Kingdom overview.
India · Schedule VDA
- Selling, swapping or spending what you hold on BtcBox. Each sale or swap is a transfer taxed at a flat 30% plus 4% cess on the gain. Losses can’t be set off, and only the cost of acquisition is deductible. More on BtcBox in India
- Moving coins to or from BtcBox. Moving crypto between your own wallets and exchanges isn’t a transfer. More on BtcBox in India
Full rules: the India crypto tax guide in the help centre, or the India overview.
See the rules for your country.
Worked example
How the tax adds up.
A typical BtcBox sale, with the tax shown for the country you picked. The numbers are for illustration only; yours come from your own history.
Illustrative · United States
| Proceeds | $3,500 |
|---|---|
| Cost basis (FIFO) | −$2,000 |
| Long-term gain | $1,500 |
| Tax at the 15% long-term rate | $225 |
Held a year or less, the same gain would be taxed at your ordinary rate, for example 22%: $330. The full example in the help centre.
Illustrative · United Kingdom
| Net gain | £20,000 |
|---|---|
| Less the annual exempt amount | −£3,000 |
| Taxable gain | £17,000 |
| £10,270 in the basic-rate band × 18% | £1,848.60 |
| Remaining £6,730 × 24% | £1,615.20 |
| Capital Gains Tax | £3,463.80 |
Your salary decides how much of the gain falls in the 18% band. The full example in the help centre.
Illustrative · India
| Sale value | ₹1,50,000 |
|---|---|
| Cost of acquisition | −₹1,00,000 |
| Gain (the ₹500 fee isn’t deductible) | ₹50,000 |
| Tax at 30% | ₹15,000 |
| Cess at 4% | ₹600 |
| Total tax | ₹15,600 |
| Less 1% TDS already deducted | −₹1,500 |
| Balance at filing | ₹14,100 |
A loss on another coin wouldn’t reduce this: VDA losses can’t be set off. The full example in the help centre.
At a glance
BtcBox in brief.
| Listed jurisdiction | Japan |
|---|---|
| Markets | spot |
| How HashBooks connects | API for transfers, file for trades |
| History it gives HashBooks | |
| Website | btcbox.co.jp |
| API documentation | blog.btcbox.jp |
| Fee schedule | support.btcbox.co.jp |
Jurisdiction, markets and links as listed in the open-source ccxt library (4.5.85), which HashBooks uses to connect to exchanges.
Security
A read-only BtcBox key, and nothing more.
HashBooks has no code that can trade, withdraw or transfer on BtcBox. The key is encrypted with AES-256-GCM and deleted when you disconnect. How HashBooks keeps data safe.
Questions
BtcBox, answered.
Does BtcBox report my trades to the tax office?
Reporting depends on where BtcBox is regulated and where you live, so don’t rely on it. Your return has to include every sale and swap across all your platforms, which is what HashBooks brings together.
Why do I need a file for BtcBox trades?
The BtcBox API gives HashBooks your balances but not your trades. Download your trade history from BtcBox and upload it with the HashBooks template; the two sources land in the same ledger.
How do I get my BtcBox transaction history for taxes?
Connect BtcBox with a read-only API key and HashBooks pulls the history for you. You can also export a statement from BtcBox and upload it with the HashBooks template.
Which HashBooks plan do I need for BtcBox?
Connecting BtcBox and seeing an estimated tax summary is free for up to 100 transactions across 3 connections. Filing reports for your country start on the Starter plan; see pricing.
Can HashBooks trade or withdraw on BtcBox?
No. The key you create is view-only, and HashBooks contains no code that can trade, withdraw or transfer. It’s encrypted with AES-256-GCM and deleted the moment you remove BtcBox.
Something else? Read all questions and answers, ask us or browse the help centre.
Ready?
Your BtcBox report, free to start.
Free to start. Read-only from the first click.