Skip to main content

How to import Trading Bot Data into Blockpit manually?

Updated over 2 weeks ago

This article explains how to import Exchange-Native Trading Bots Data (e.g. Pionex, BingX and others) into Blockpit meaning bot products that are directly offered and executed by exchanges (e.g. Grid Bots, DCA Bots, Futures Bots, etc.). It does not cover external third-party trading bots that connect to exchanges via API as these may already be included in the respective API/CSV import scope.

Exchange-Native Trading Bots can look similar in the exchange UI, but they don’t all produce the same kind of data. Some bots generate normal spot buys and sells, others use borrowed funds (margin), and some trade futures/perpetuals/options and output profit/loss plus funding and fees.

πŸ† This guide shows you how to identify the bot type and import the data into Blockpit even if you only see final results in the exchange UI.

πŸ” Step 1: Understand the Bot Structure

Before importing anything, clarify which type of bot you are dealing with.

What matters is:

  • what the bot actually trades in the background

  • which data your exchange provides (API, CSV/Excel export or UI-only results)

  • whether the activity is spot, margin or derivatives

Once you identify this structure, importing the data into Blockpit becomes much clearer.

πŸ“ˆ Spot Trading Bots

Spot bots (e.g. grid bots, DCA strategies, rebalancing bots) execute regular buy and sell transactions on the spot market. From a reporting perspective, nothing special happens, the bot simply generates normal spot trades.

Used Blockpit Label:

If your exchange provides a full trade history via API or CSV, you can import it like any other exchange activity. No PnL calculation is required because spot taxation is based on individual buy and sell events.

πŸ’‘ If the export looks like normal buy/sell fills including fees, you are most likely dealing with spot market trades.

πŸ’³ Spot Margin Bots

Spot margin bots combine spot trades with borrowed funds. The activity usually consists of:

  • spot buy and sell transactions

  • borrow events

  • repayment events

  • sometimes interest

In Blockpit, this must be reflected correctly.

Used Blockpit Labels:

Margin trading does not require derivative PnL labels. However, missing loan or repayment entries are one of the most common reasons for balance mismatches.

πŸ“Š Futures / Perpetual / Options Bots

Derivatives bots trade contracts instead of spot assets. Typical UI elements include:

  • realized PnL

  • funding fees

  • position size

  • liquidation price

Tax reporting for these bots is based on realized profit or loss.

Used Blockpit Labels:

Spot trade entries alone are not sufficient.

⚠️ If the exchange shows funding payments or position-based PnL instead of buy/sell history, you are dealing with derivatives.

πŸ”— Step 2: Import via API or CSV (Preferred)

Whenever possible, use API or official CSV exports.

For spot bots, the trade history is usually enough.
​For margin bots, ensure that trade history and margin ledger (borrow/repay) are included.
​For derivatives bots, check that realized PnL and funding/fee data are available.

Some exchanges split the data across multiple exports, for example or even provide the data via a sub-account API key.

  • trade history

  • income history

  • funding history

  • margin ledger

Make sure all relevant files are included before uploading.

If the data already contains full underlying activity, you can upload it directly or migrate it into the Blockpit Excel Template.

πŸ“ Step 3: Manual Import Using the Blockpit Excel Template

If no suitable export is available, use the official Blockpit Excel Template and enter/migrate your data manually.

Spot Bots (Manual)

Enter each buy and sell individually as:

Include fees as provided.

Spot Margin Bots (Manual)

You must enter:

Include fees as provided. If loan entries are missing, balances will not match.

Derivatives Bots (Manual)

For derivatives activity, enter:

⚠️ Important: Exchanges calculate PnL differently. Realized PnL may already include:

  • partial take profits

  • top-ups of positions

  • multiple partial closes

  • funding fees

  • trading fees

Always verify whether funding and fees are already deducted from the PnL number to avoid double counting.

πŸ–₯️ Special Case: Only Final Bot PnL in the UI

Some exchanges do not provide granular transaction exports. Instead, they only display a final strategy result such as total profit or net PnL inside the dashboard.

If detailed history is not accessible, you can abstract the result into Blockpit.

Used Blockpit Labels:

In this UI-only scenario, it is generally consistent to assign the result to the tax year in which the bot was closed and the profit or loss was realized.

πŸ’‘ Whenever possible, prefer importing detailed transaction history instead of a single aggregated result.

πŸ”§ If Balances Don’t Match

Mismatched Balances often result from incomplete exports, for example:

  • missing Receive Loan / Repay Loan entries

  • missing funding fees

  • limited export timeframes

  • bot sub-accounts not included

  • missing historical starting balances

Blockpit offers an auto-balancing feature that can generate corrective transactions if historical data is missing. These transactions should always be reviewed carefully and adjusted if necessary (for example relabeled as Non-Taxable Deposits if they correct missing starting balances).

In many cases, manually completing the missing history (loans, funding, transfers) provides the most accurate and audit-proof result.

βœ… Final Checklist

  1. Confirm whether the bot is spot, spot margin or derivatives.

  2. Use the correct labels: Trade (spot), Receive Loan, Repay Loan, Derivative Profit, Derivative Loss, Derivative Fee.

  3. Verify whether funding and fees are already included in the PnL figure.

  4. Ensure only realized results are imported.

  5. Check that balances match without unexplained negative amounts.

Did this answer your question?