How to export your Kalshi trade history

1. The Documents CSV export (no key needed)

1. On desktop, open the account menu (top right) and choose Documents. The tab is not in the mobile app.
2. Download the positions export. You get one CSV row per matched position, not per fill.
3. Columns you will see: market_ticker, side, quantity, entry_price_cents, open_fees_cents, open_timestamp, plus the closing price, fees and timestamp for closed positions.

Prices and fees are integer cents per contract, so a 40¢ yes withquantity 25 is $10.00 of exposure before fees. Note that this format replaced the older Ticker, Type, Direction, Contracts, Average_Price, Createdtransaction export in 2025. Scripts and community dashboards built on the old layout stopped working at that point; the open-source kalshi-dash, for example, only caught up with the new column names in August 2026. Check any parser you rely on against a fresh export.

2. Create a read-only API key

1. Open the menu (top right) and go to Account & security.
2. Scroll to API Keys and click Create Key.
3. Give it a nickname and select Read only, not Read/write.
4. Kalshi generates the RSA keypair for you. Save the downloaded private key file and copy the Key ID. The private key is shown once and cannot be retrieved later.

A read-only key can list your fills, settlements, positions, orders and balance. It cannot place or cancel orders or withdraw. Read-only access does not require a funded account either, so it is safe to create just for analytics.

3. Pull fills and settlements from the API

Portfolio endpoints are authenticated: every request carries your key ID, a millisecond timestamp and an RSA-PSS (SHA-256, salt 32) signature of {timestamp}{METHOD}{path}, where path excludes the query string.

GET https://api.elections.kalshi.com/trade-api/v2/portfolio/fills?limit=1000&min_ts=1751328000
GET https://api.elections.kalshi.com/trade-api/v2/portfolio/settlements?limit=1000

• Each fill has ticker, side (yes or no), action (buy or sell), count_fp, yes_price_dollars / no_price_dollars, is_taker, fee_cost (dollars, authoritative) and created_time.
• min_ts lets you sync incrementally; store the newest created_time you have seen and pass it next run.
• Settlements give you market_result (yes or no) and settled_time per ticker, which is what turns open positions into realized P&L.
• Fills older than roughly three months move to /historical/fills. See the order book and historical data guide for the cutoff endpoint and pagination.

4. Minimal Python: all fills to CSV

import base64, csv, time, requests
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding

BASE = "https://api.elections.kalshi.com/trade-api/v2"
KEY_ID = "your-key-id"
PRIV = serialization.load_pem_private_key(open("kalshi.key", "rb").read(), password=None)

def headers(method, path):
    ts = str(int(time.time() * 1000))
    msg = f"{ts}{method}/trade-api/v2{path}".encode()
    sig = PRIV.sign(msg, padding.PSS(mgf=padding.MGF1(hashes.SHA256()),
                                     salt_length=32), hashes.SHA256())
    return {"KALSHI-ACCESS-KEY": KEY_ID, "KALSHI-ACCESS-TIMESTAMP": ts,
            "KALSHI-ACCESS-SIGNATURE": base64.b64encode(sig).decode()}

def all_fills():
    cursor = ""
    while True:
        r = requests.get(BASE + "/portfolio/fills", headers=headers("GET", "/portfolio/fills"),
                         params={"limit": 1000, "cursor": cursor}).json()
        yield from r["fills"]
        cursor = r.get("cursor") or ""
        if not cursor:
            break

with open("kalshi_fills.csv", "w", newline="") as f:
    w = csv.writer(f)
    w.writerow(["ticker", "side", "action", "count", "price", "fee", "time"])
    for x in all_fills():
        price = x["yes_price_dollars"] if x["side"] == "yes" else x["no_price_dollars"]
        w.writerow([x["ticker"], x["side"], x["action"], x["count_fp"], price,
                    x.get("fee_cost", "0"), x["created_time"]])

From here P&L is bookkeeping: match buys to sells or settlements per ticker and side, subtract fee_cost on every leg. The fee is where most home-made spreadsheets go wrong; read how Kalshi fees work before trusting your totals, or check a single trade with the fee calculator.

5. Or skip the script

FillBook does the above for you. Paste a read-only key (or upload the Documents CSV, no key at all) and it imports fills and settlements, applies Kalshi's official market categories, and shows realized P&L with fees folded in, win rate by category, equity curve and edge by holding time. It syncs daily on its own.

See the live demo → or import your own fills. Free for the last 60 days, no card.