# Networks and conventions

> Check Trading API network support, pagination, amounts, timestamps, and errors.

> 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>


Choose a network and variant for your task before sending a request.

## Supported networks (private preview)

A check means supported in the private preview; a dash means not yet supported in the preview. The seven groups cover all 13 capabilities and both variants.

### Pool

Applies to [Get pool](/docs/data/trading-api/endpoints/pools/get-pool), [Get pool candles](/docs/data/trading-api/endpoints/pools/get-pool-candles), [Get pool trades](/docs/data/trading-api/endpoints/pools/get-pool-trades). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | ✓ | ✓ |
| Optimism | `opt-mainnet` | – | – |
| Polygon | `matic-mainnet` | – | – |
| Avalanche | `avax-mainnet` | – | – |
| Linea | `linea-mainnet` | – | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | – |
| Robinhood | `robinhood-mainnet` | – | – |
| Arc | `arc-mainnet` | – | – |
| Tempo | `tempo-mainnet` | – | – |

Support for more networks is planned.

### Token and search

Applies to [Get token candles](/docs/data/trading-api/endpoints/tokens/get-token-candles), [Get token trades](/docs/data/trading-api/endpoints/tokens/get-token-trades), [Get pools for a token](/docs/data/trading-api/endpoints/tokens/get-pools-for-a-token), [Search tokens and pools](/docs/data/trading-api/endpoints/discovery/search-tokens-and-pools). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | ✓ | ✓ |
| Optimism | `opt-mainnet` | ✓ | – |
| Polygon | `matic-mainnet` | ✓ | – |
| Avalanche | `avax-mainnet` | ✓ | ✓ |
| Linea | `linea-mainnet` | ✓ | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | ✓ |
| Robinhood | `robinhood-mainnet` | – | – |
| Arc | `arc-mainnet` | – | – |
| Tempo | `tempo-mainnet` | – | – |

### Holder

Applies to [Get top holders](/docs/data/trading-api/endpoints/tokens/get-top-holders). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | ✓ | – |
| Optimism | `opt-mainnet` | ✓ | – |
| Polygon | `matic-mainnet` | ✓ | – |
| Avalanche | `avax-mainnet` | ✓ | ✓ |
| Linea | `linea-mainnet` | ✓ | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | ✓ |
| Robinhood | `robinhood-mainnet` | – | – |
| Arc | `arc-mainnet` | – | – |
| Tempo | `tempo-mainnet` | – | – |

### New pool

Applies to [Get new pools](/docs/data/trading-api/endpoints/discovery/get-new-pools). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | ✓ | ✓ |
| Optimism | `opt-mainnet` | ✓ | – |
| Polygon | `matic-mainnet` | ✓ | – |
| Avalanche | `avax-mainnet` | ✓ | ✓ |
| Linea | `linea-mainnet` | – | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | ✓ |
| Robinhood | `robinhood-mainnet` | ✓ | ✓ |
| Arc | `arc-mainnet` | ✓ | ✓ |
| Tempo | `tempo-mainnet` | – | – |

### Screening and token list

Applies to [Screen pools](/docs/data/trading-api/endpoints/discovery/screen-pools), [Get token list](/docs/data/trading-api/endpoints/discovery/get-token-list). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | ✓ | ✓ |
| Optimism | `opt-mainnet` | ✓ | – |
| Polygon | `matic-mainnet` | ✓ | – |
| Avalanche | `avax-mainnet` | ✓ | ✓ |
| Linea | `linea-mainnet` | ✓ | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | ✓ |
| Robinhood | `robinhood-mainnet` | ✓ | ✓ |
| Arc | `arc-mainnet` | ✓ | ✓ |
| Tempo | `tempo-mainnet` | – | ✓ |

### Wallet PnL

Applies to [Get wallet PnL](/docs/data/trading-api/endpoints/wallets/get-wallet-pnl). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | ✓ | ✓ |
| Base | `base-mainnet` | ✓ | ✓ |
| Arbitrum | `arb-mainnet` | ✓ | ✓ |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | – | ✓ |
| Optimism | `opt-mainnet` | ✓ | – |
| Polygon | `matic-mainnet` | ✓ | – |
| Avalanche | `avax-mainnet` | ✓ | ✓ |
| Linea | `linea-mainnet` | ✓ | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | ✓ |
| Robinhood | `robinhood-mainnet` | ✓ | ✓ |
| Arc | `arc-mainnet` | ✓ | ✓ |
| Tempo | `tempo-mainnet` | – | ✓ |

General accepts EVM networks only; every network in a multi-network request must be EVM. Premium accepts an optional `networks` list. Omit it to combine all supported EVM networks. Request `solana-mainnet` on its own; do not combine Solana with EVM networks.

### Wallet trade

Applies to [Get wallet trades](/docs/data/trading-api/endpoints/wallets/get-wallet-trades). Each linked General operation has a matching Premium operation.

| Network | Slug | General | Premium |
| --- | --- | --- | --- |
| Ethereum | `eth-mainnet` | – | ✓ |
| Base | `base-mainnet` | – | ✓ |
| Arbitrum | `arb-mainnet` | – | – |
| BNB Smart Chain | `bnb-mainnet` | ✓ | ✓ |
| Solana | `solana-mainnet` | – | ✓ |
| Optimism | `opt-mainnet` | – | – |
| Polygon | `matic-mainnet` | – | – |
| Avalanche | `avax-mainnet` | – | – |
| Linea | `linea-mainnet` | – | – |
| Hyperliquid (HyperEVM) | `hyperliquid-mainnet` | – | – |
| Robinhood | `robinhood-mainnet` | – | ✓ |
| Arc | `arc-mainnet` | – | – |
| Tempo | `tempo-mainnet` | – | – |

General wallet trades supports `bnb-mainnet`. Range requests are limited.

## Read amounts and timestamps

USD values and token amounts are decimal strings so you can preserve precision. Use decimal arithmetic for calculations; converting these strings to JavaScript numbers can lose precision. `null` means unknown, not zero. Every row carries its Alchemy `network` slug. Other timestamps use ISO 8601 UTC; candle `timestamp` values use Unix seconds UTC.

## Choose token or pool scope

Pool operations describe one pool. Token operations describe the selected token: candles are built from the token’s pool activity. Premium can aggregate across pools. The aggregation request control remains pending. Pool candle price orientation must be checked before comparing it with a token chart. Empty candle intervals are omitted by default; preserve those gaps instead of treating them as zero-volume candles or interpolating prices.

New pool operations return recently created pools. Range requests are limited; split a longer analysis into smaller requests. Time-range boundary inclusion is pending, so account for duplicates when combining adjacent requests.

## Continue through pages

Omit `pageKey` on your first request. Copy each returned opaque key unchanged into the next request, keeping your filters fixed. Stop only when `pageKey` is `null`. Treat a missing key or a repeated key as an error. The proposed `pageSize` default is 25 and maximum is 100. Pagination applies only where an operation exposes it.

## Interpret wallet PnL

General uses average cost for lifetime realized and unrealized PnL, broken down by network and token. Premium reports realized PnL for `1d`, `7d`, `30d` (the default), or `all`. Its history uses hourly buckets for `1d` and `7d`, and daily buckets for `30d` and `all`. Its summary includes trade count, wins, losses, and win rate. The methods and measurement periods differ, so the General and Premium PnL numbers are not comparable.

## Handle errors and retries

Errors use `{ "error": { "message": "..." } }`. Correct a `400` request before retrying and check your API key for `401`. Retry `429` and `503` with bounded exponential backoff. When `Retry-After` is present, wait at least its duration, interpreting either seconds or an HTTP date. Surface other errors and exhausted retries. The [quickstart](/docs/data/trading-api/quickstart) includes TypeScript retry handling.

## Update frequency

Pending. We have not defined update frequency for this preview.