> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bebop.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Look up historical trades and transaction details across all Bebop-supported chains.

The Trade History API gives you read-only access to every trade executed through Bebop. Look up trades by wallet address or inspect individual transactions - all from a single endpoint that aggregates across every supported chain.

## When to Use

* You need **post-trade analytics** - reconciling fills, tracking volumes, or attributing trades to your integration via the `source` parameter
* You want to **inspect any Bebop transaction across all supported chains** from a single endpoint, without querying each chain separately

## At a Glance

|                    |                                                 |
| ------------------ | ----------------------------------------------- |
| **Transport**      | REST                                            |
| **Authentication** | Optional (required only for `source` filtering) |
| **Base URL**       | `https://api.bebop.xyz/history/v2/`             |
| **Complexity**     | Low - standard REST GET requests                |

## How It Works

| Step | Action                | You send                                  | You get back                                      |
| ---- | --------------------- | ----------------------------------------- | ------------------------------------------------- |
| 1    | Query trades          | Wallet address → `GET /history/v2/trades` | Paginated list of trades with token + USD details |
| 2    | Inspect a transaction | Tx hash → `GET /history/v2/tx/{tx_hash}`  | Full trade breakdown: tokens, amounts, gas, type  |

To filter by `source` (partner attribution), [authenticate with your API key](/core-concepts/authentication).

## Key Endpoints

| Endpoint                       | Purpose                                                       |
| ------------------------------ | ------------------------------------------------------------- |
| `GET /history/v2/trades`       | Query trades by wallet address with time range and pagination |
| `GET /history/v2/tx/{tx_hash}` | Look up a specific transaction by hash                        |

## Next Steps

<CardGroup cols={1}>
  <Card title="Quickstart" icon="bolt" href="/trade-history-api/quickstart">
    Fetch your first trade history in a few minutes.
  </Card>
</CardGroup>