---
title: "List investment trades for an account"
method: GET
path: "/v1/banks/{bid}/accounts/{aid}/trades"
tags: ["Trades"]
---

# List investment trades for an account

`GET /v1/banks/{bid}/accounts/{aid}/trades`

## Request

- Base URL: `https://api.banksync.io`
- URL: `https://api.banksync.io/v1/banks/{bid}/accounts/{aid}/trades`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Responses may be served from a cache up to 6 hours old: `X-BankSync-Cache` says `hit`, `miss` or `bypass`, and `Age` is the cached answer's age in seconds.

## Path parameters

- `bid` string, required: Bank ID
- `aid` string, required: Account ID

## Query parameters

- `from` string: Start date (YYYY-MM-DD, default last 90 days)
- `to` string: End date (YYYY-MM-DD, default today)

## Response `200`

List of trades

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required
    - `accountId` string, required
    - `bankId` string
    - `date` string, required
    - `type` string, required: buy, sell, dividend, split, etc.
    - `securityName` string
    - `securityId` string
    - `ticker` string
    - `quantity` number
    - `price` number
    - `amount` number, required
    - `fees` number
    - `currency` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

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