# Trading API

> Explore DEX market data and wallet trading analytics in private preview.

> For the complete documentation index, see [llms.txt](/docs/llms.txt).

<Callout intent="info">
  This API is in private preview. Endpoint availability and response schemas may change before general availability.
</Callout>


Find decentralized exchange (DEX) markets, chart trading activity, and analyze wallet outcomes with your existing Alchemy API key. Responses follow the same conventions as the other Alchemy Data APIs: network slugs, opaque `pageKey` pagination, and the `{ error: { message } }` error format.

## Choose a task

| I want to… | Use |
| --- | --- |
| Inspect a pool | [Get pool](/docs/data/trading-api/endpoints/pools/get-pool) |
| Chart a pool | [Get pool candles](/docs/data/trading-api/endpoints/pools/get-pool-candles) |
| Read pool trades | [Get pool trades](/docs/data/trading-api/endpoints/pools/get-pool-trades) |
| Chart a token | [Get token candles](/docs/data/trading-api/endpoints/tokens/get-token-candles) |
| Read token trades | [Get token trades](/docs/data/trading-api/endpoints/tokens/get-token-trades) |
| Find a token’s pools | [Get pools for a token](/docs/data/trading-api/endpoints/tokens/get-pools-for-a-token) |
| Inspect the largest holders | [Get top holders](/docs/data/trading-api/endpoints/tokens/get-top-holders) |
| Find newly created pools | [Get new pools](/docs/data/trading-api/endpoints/discovery/get-new-pools) |
| Screen pools | [Screen pools](/docs/data/trading-api/endpoints/discovery/screen-pools) |
| Find tokens and pools | [Search tokens and pools](/docs/data/trading-api/endpoints/discovery/search-tokens-and-pools) |
| List tokens on a network | [Get token list](/docs/data/trading-api/endpoints/discovery/get-token-list) |
| Measure wallet profit and loss | [Get wallet PnL](/docs/data/trading-api/endpoints/wallets/get-wallet-pnl) |
| Read a wallet’s trades | [Get wallet trades](/docs/data/trading-api/endpoints/wallets/get-wallet-trades) |

## Choose General or Premium

General combines lower proposed compute-unit (CU) costs with broader coverage for several capabilities. Premium adds period-based wallet PnL history and a trading summary. Network coverage varies by operation; check the [coverage tables](/docs/data/trading-api/networks-and-conventions) before choosing a variant.

General wallet PnL uses average cost to calculate lifetime realized and unrealized results, split by network and token. Premium reports realized PnL for a selected period, with history, trades, wins, losses, and win rate. **These methodologies differ, so the numbers are not comparable.**

### Proposed compute units

All CU values are proposals awaiting validation. Premium is proposed at 1.75 times General. The names General and Premium and the `/premium` prefix are also provisional.

| Capability | General CU | Premium CU |
| --- | --- | --- |
| Get pool | 200 | 350 |
| Get pool candles | 400 | 700 |
| Get pool trades | 400 | 700 |
| Get token candles | 400 | 700 |
| Get token trades | 400 | 700 |
| Get pools for a token | 200 | 350 |
| Get top holders | 200 | 350 |
| Get new pools | 400 | 700 |
| Screen pools | 400 | 700 |
| Search tokens and pools | 200 | 350 |
| Get token list | 200 | 350 |
| Get wallet PnL | 800 | 1,400 |
| Get wallet trades | 800 | 1,400 |

<CardGroup cols={3}>
  <Card title="Quickstart" href="/docs/data/trading-api/quickstart">Find a market, read trades, and interpret PnL.</Card>
  <Card title="Networks and conventions" href="/docs/data/trading-api/networks-and-conventions">Check coverage and request conventions.</Card>
  <Card title="Endpoint reference" href="/docs/data/trading-api/endpoints/pools/get-pool">Inspect request and response schemas.</Card>
</CardGroup>

## Pending

* Request paths, parameter placement, and response fields are provisional.
* Tier names and the `/premium` path prefix remain under review.
* The base URL is provisional until confirmed before general availability.
* Compute-unit costs await validation.
* Update frequency is not yet defined.
* Support for more networks is planned.