---
title: "Your trade history"
method: GET
path: "/api/v1/me/trades"
tags: ["Account"]
---

# Your trade history

`GET /api/v1/me/trades`

## Request

- Base URL: `https://arbitron.app`
- URL: `https://arbitron.app/api/v1/me/trades`
- Auth: HTTP bearer

Executed trades over a window of up to 31 days (default: the last 7), grouped by card: per card the net PnL, profit percent on capital, fees, funding and fills, and the newest paired trades with both legs, the venue's order id and any unwind. Window totals cover every trade.

At most 300 pairs are listed in one answer across all cards; `pairs_truncated` says when more exist. For daily or monthly totals over longer periods use `/me/pnl`.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `card_ref` string
- `pairs_per_card` integer

## Response `200`

OK

- ApiEnvelopeOfAccountTrades
  - `data` AccountTrades, required
    - `from` string, date-time, required
    - `to` string, date-time, required
    - `net_pnl_usd` number, double, required
    - `fees_usd` number, double, required
    - `rebate_usd` number, double, required
    - `volume_usd` number, double, required
    - `fills` integer, required
    - `pairs_truncated` boolean, required
    - `cards` AccountCardTrades[], required
      - `card_ref` string, required
      - `name` string, required
      - `status` string, required
      - `net_pnl_usd` number, double, required
      - `profit_pct` number, double, nullable, required
      - `fees_usd` number, double, required
      - `funding_usd` number, double, required
      - `fills` integer, required
      - `pairs_total` integer, required
      - `pairs` AccountTradePair[], required
        - `time` string, date-time, required
        - `action` string, nullable, required
        - `net_pnl_usd` number, double, required
        - `fees_usd` number, double, required
        - `expected_spread_pct` number, double, required
        - `leg_a` AccountTradeLeg, required
          - `exchange` string, required
          - `side` string, required
          - `price` number, double, required
          - `quantity` number, double, required
          - `notional_usd` number, double, required
          - `fee_usd` number, double, required
          - `exchange_order_id` string, nullable, required
        - `leg_b` AccountTradeLeg, required
          - `exchange` string, required
          - `side` string, required
          - `price` number, double, required
          - `quantity` number, double, required
          - `notional_usd` number, double, required
          - `fee_usd` number, double, required
          - `exchange_order_id` string, nullable, required
        - `unwind` AccountTradeLeg, required
          - `exchange` string, required
          - `side` string, required
          - `price` number, double, required
          - `quantity` number, double, required
          - `notional_usd` number, double, required
          - `fee_usd` number, double, required
          - `exchange_order_id` string, nullable, required
  - `meta` ApiMeta, required
    - `as_of` string, date-time, required
    - `delayed_seconds` integer, required
    - `source` string, required
    - `url` string, required
    - `count` integer, nullable
    - `total` integer, nullable
    - `next_cursor` string, nullable
    - `withheld` integer, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/arbitron/apis/arbitron-api.md) · [All operations](https://skmtc.dev/arbitron/apis/arbitron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arbitron/apis/arbitron-api/revisions/dd08806fd48e?raw)