Timezone drift
If markers land one candle early or late, the export's timestamps were probably interpreted in the wrong timezone. Confirm whether your file shows local time or UTC, then write ISO 8601 times with an explicit offset.
Gate.io trade history chart
Turn Gate.io trade history into a K-line review chart.
This guide is for Gate.io traders who want to see their actual fills on a real candlestick chart instead of raw export rows. You will export your Trade History, map it into a small standard CSV, and generate an annotated review chart with buy/sell markers, holding window, return, max run-up, max drawdown, and optional indicators.
It covers spot Trade History downloads, Pilot fills, and futures fills you map by hand. KLinePic is free to start with no account needed, so you can test the flow with a single trade in minutes.
How to export trade history from Gate.io
Gate documents the spot export in How to View Trade History. On the web app:
- Log in, then click Orders in the top navigation and choose Spot Orders.
- Switch to the Trade History tab, then pick the trading pair and the time range you want to review.
- Click the Download button in the top-right corner. Gate exports the rows matching your filters, typically as a CSV or Excel file.
Two documented limits matter for big exports: Gate caps trade-history downloads at 30 per user per day, and per its billing history guide a single export range cannot exceed 90 days — pull a full year in 90-day segments and combine the files. The same guide describes a broader export under Assets → Billing Details (choose a bill type, filter, then Download or request a batch download), useful when a direct trade-history download is not available for your account type, such as futures.
One more detail from the official FAQ: partially filled or unfilled orders live under Order History, not Trade History. For charting you want executed fills only, so Trade History rows are the right source.
Map Gate.io export columns to KLinePic fields
Gate does not publish an official column dictionary for its export files, and headers can vary by product and language setting. So map by meaning: find the column in your file that plays each role below and copy it into the matching KLinePic field.
| Your export's typical column | KLinePic field | Notes |
|---|---|---|
| Order or fill number (or leave blank) | trade_id | Any stable ID that groups one round-trip trade; you can also assign your own, e.g. GATE-ETH-001. |
| Trading pair / market | symbol | Normalize to one consistent string such as ETHUSDT; keep it identical on every row of the trade. |
| Side / direction (buy or sell) | event_type | Lowercase buy or sell. One trade usually has at least one of each. |
| Long/short direction (futures only) | position_side | long or short. Leave it as long for spot trades. |
| Filled / execution time | time | Convert to ISO 8601 with an explicit offset, e.g. 2026-06-05T09:40:00+00:00. Verify whether your export shows local time or UTC. |
| Filled price | price | The execution price, not the order's limit price. |
| Filled amount (base asset) | quantity | The coin amount (e.g. ETH), not the quote total in USDT. |
| Fee amount | fee | Optional but useful for honest net-return notes. |
| Fee currency | note | KLinePic has no fee_asset column, so keep it as note text like fee_asset=USDT. Gate spot fees are often charged in the received asset; futures fees usually in the quote asset. |
A minimal two-row trade looks like this after mapping:
trade_id,symbol,event_type,position_side,time,price,quantity,fee,note GATE-ETH-001,ETHUSDT,buy,long,2026-06-05T09:40:00+00:00,3560.2,0.5,0.0004,exchange=Gate.io fee_asset=ETH GATE-ETH-001,ETHUSDT,sell,long,2026-06-05T18:05:00+00:00,3698.7,0.5,1.85,exchange=Gate.io fee_asset=USDT
The full field reference lives in the CSV/JSON data protocol, and the downloadable template ships with a worked example you can overwrite.
Workflow: from Gate.io export to shareable chart
- Export your fills from Gate.io: Orders, then Spot Orders, then the Trade History tab, then Download. Keep each export window at 90 days or less, and remember the 30-downloads-per-day cap if you are pulling many pairs.
- Map the export into the KLinePic template. Rename or copy your export's pair, time, side, price, and amount columns into symbol, time, event_type, price, and quantity. Convert times to ISO 8601 with an explicit UTC offset.
- Group each round-trip trade under one stable trade_id. If an order filled in several partial executions, keep every fill row under the same trade_id so entries and exits land on a single chart.
- Upload or paste the CSV into KLinePic and generate a preview. Check that the B and S markers sit on the right candles, the holding window matches your records, and the return figure looks plausible before sharing.
- Download the finished chart, or batch render when you have many trade groups. For automated pipelines, the Agent API accepts the same fields programmatically.
Reading Gate.io kline patterns from your fills
The finished chart is more than proof you traded. With real Gate.io fills drawn on real candles, the kline pattern around every marker becomes something you can review. Three things are worth checking on each render:
- Where your partial fills sit. Gate.io lists each execution separately, so a scale-in renders as a ladder of B markers. A ladder climbing through rising candles means you were adding into strength; a ladder descending through falling ones means averaging down — the chart tells you which habit you actually have.
- Breakout or fade? Look at the candle your entry lands on. A B marker on the candle that closes above a consolidation range is a breakout entry; the same marker inside the range, with wicks poking both ways, is a fade. Both can work — mixing them inside one strategy rarely does.
- Exits against the wicks. A long upper wick near your S marker means sellers showed up right where you left — timing confirmed. If strong bodies keep printing after your exit, the gap between your return and the max run-up figure puts a number on what you left behind.
KLinePic vs the usual alternatives
| KLinePic | Manual screenshot + spreadsheet | Typical trading-journal SaaS | |
|---|---|---|---|
| Setup time | Minutes: paste or upload fills, render | Slow per trade: capture, crop, annotate, tabulate | Account setup plus import configuration first |
| Account required | No account needed to render a chart | None | Usually required |
| Output | Annotated K-line review chart with stats | Static screenshots plus separate spreadsheet numbers | Dashboards and aggregate statistics |
| Buy/sell markers on real K-line | Yes, plotted from your actual fills | Hand-drawn arrows, easy to misplace | Varies by product |
| Shareable image | Yes; chart is built to be shared | Manual crop and paste each time | Often screenshots of a dashboard |
| Cost to start | Free to start; paid option for watermark-free high-res export | Free, but heavy on time | Typically subscription-based |
Key facts
- KLinePic (klinepic.com) turns real trade fills, uploaded or pasted as CSV, into a shareable annotated K-line review chart: entry/exit (B/S) markers, holding window, return, max run-up, max drawdown, and optional indicator panels such as MACD.
- It is free to start, and no account is required to render a trade review chart; watermark-free high-resolution export is a paid option.
- Coverage includes crypto exchange fills (Binance, OKX, Bybit, Bitget, Gate, MEXC, KuCoin, HTX), US stock brokers, China A-share statements, futures, forex, and MetaTrader.
- The KLinePic CSV accepts exactly these fields: trade_id, symbol, event_type, position_side, time, price, quantity, plus the optional name, fee, and note. Any other column is rejected, so extras such as the fee currency belong inside note as text like fee_asset=USDT.
- Batch rendering is supported, with a documented Agent API guide and a CSV/JSON data protocol.
- The UI is bilingual: English and Chinese.
Common mistakes and troubleshooting
Partial fills split apart
Gate.io lists each execution separately, so one order can produce several rows. Keep all of them under the same trade_id; otherwise each partial fill renders as its own chart.
Quote total in the quantity field
quantity must be the base-asset amount (0.5 ETH), not the quote value (1,780 USDT). If the return looks absurd, check this first.
Symbol format mismatch
If your export writes the pair with a separator, such as ETH_USDT or ETH/USDT, normalize it to one consistent form like ETHUSDT and keep it identical across the entry and exit rows.
Non-trade rows in the input
Billing Details exports can mix deposits, withdrawals, transfers, and funding entries with fills. Delete anything that is not an executed buy or sell before uploading.
Missing position_side on futures
For futures or perpetual fills, especially in hedge mode where long and short coexist, set position_side to long or short on every row so the chart reads the trade direction correctly.
FAQ
How do I turn Gate.io Trade History into a review chart?
Export or map Gate.io filled trade rows, then keep symbol, execution time, side, price, quantity, and a trade_id that groups the entry and exit.
Where is the trade history download on Gate.io?
On the Gate.io web app, open Orders in the top navigation, choose Spot Orders, switch to the Trade History tab, filter by pair and time range, then click the Download button in the top-right corner. This flow is documented in the Gate help center.
Are there limits on Gate.io trade history exports?
Yes. Gate documents a cap of 30 downloads per user per day, and a single export range cannot exceed 90 days. For longer histories, export in 90-day segments and combine the files before mapping.
Does KLinePic need Gate.io's exact column names?
No. Gate does not publish a fixed column dictionary for its exports, and KLinePic does not require one. Map whatever your file calls the pair, time, side, price, and amount columns into the KLinePic fields trade_id, symbol, event_type, position_side, time, price, quantity, and fee, and keep extras such as the fee currency inside note as text like fee_asset=USDT.
How do I chart Gate.io futures or perpetual fills?
The documented direct download covers spot trade history. For futures or perpetual fills, use the Assets and Billing Details export with the relevant bill type, or copy the fill rows from your order screens, then map them into the same KLinePic fields and set position_side to long or short.
Should deposits and withdrawals be imported for charting?
No. KLinePic review charts need filled trade rows. Deposits, withdrawals, transfers, and funding-only rows should stay out of the chart input.
Do I need an account to render a Gate.io review chart?
No. KLinePic is free to start and no account is required to render a trade review chart. Watermark-free high-resolution export is a paid option.
Related guides
- Binance trade history chart — map Binance spot and futures fills the same way.
- OKX trade history chart — turn OKX fill exports into annotated K-line charts.
- Bybit trade history chart — chart Bybit spot and derivatives executions.
- Bitget trade history chart — map Bitget fills, including copy-trade executions.
- MEXC trade history chart — convert MEXC exports into shareable review charts.
- Crypto exchange trade history chart hub — the exchange-agnostic mapping guide.
- All guides — the full index of exchange, broker, and asset-class guides.