---
title: "Paper account"
method: GET
path: "/api/bot/v1/account"
tags: ["Paper trading"]
---

# Paper account

`GET /api/bot/v1/account`

## Request

- Base URL: `https://marginpad.io`
- URL: `https://marginpad.io/api/bot/v1/account`
- Auth: API key in header `X-API-Key`

Open positions, margin in use, unrealized P&L, LIFETIME realized P&L, wins/losses, win rate, plus balance_usd, equity_usd, free_margin_usd and return_pct.

## Response `200`

ok

- Account
  - `open_positions` integer
  - `margin_in_use_usd` number
  - `unrealized_pnl_usd` number
  - `realized_pnl_usd` number: LIFETIME, not the last 100 trades.
  - `closed_trades` integer
  - `wins` integer
  - `losses` integer
  - `win_rate_pct` number, nullable
  - `starting_balance_usd` number
  - `balance_usd` number
  - `equity_usd` number
  - `free_margin_usd` number
  - `return_pct` number
  - `best_trade_usd` number, nullable
  - `margin_enforced` boolean: Always false: the balance is a scorecard, opens are never rejected for lack of funds.

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)