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.
π Blockpit Excel Template β Manual Import Guide
π How to Import PnL Manually
π Understanding Transaction Labels in Blockpit
π 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:
borrowed amount β
Receive Loanrepayment β
Repay Loantrades β
Trade (spot)
Include fees as provided. If loan entries are missing, balances will not match.
Derivatives Bots (Manual)
For derivatives activity, enter:
positive realized result β
Derivative Profitnegative realized result β
Derivative Lossfunding and trading costs β
Derivative Fee
β οΈ 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:
positive result β
Derivative Profitnegative result β
Derivative Lossseparately displayed funding or fees β
Derivative Fee
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 Loanentriesmissing 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
Confirm whether the bot is spot, spot margin or derivatives.
Use the correct labels:
Trade (spot),Receive Loan,Repay Loan,Derivative Profit,Derivative Loss,Derivative Fee.Verify whether funding and fees are already included in the PnL figure.
Ensure only realized results are imported.
Check that balances match without unexplained negative amounts.