# Pools Source: https://www.solscanner.app/docs/indexer/reference/pools > Pool identity, swaps, ticks, candles, liquidity and rolling statistics, including Uniswap V4. Everything keyed by a pool. V4 pools are keyed by manager address plus pool id rather than a pool address, so they have their own parallel route set. Liquidity is protocol-native: V2 reserves and concentrated-liquidity depth are different measurements and are not merged. 20 routes. Every path below is served under `/index/v1/{chain}`, and every request carries an `x-api-key` header, so those two are not repeated per route. The shared contract for pagination, snapshots, precision and absence is in [Read API](/docs/indexer/api). Pools By Currency [#pools-by-currency] ```http GET /currencies/{currency}/pools ``` Pools holding a given currency on either side. | Parameter | In | Required | Notes | | ---------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `currency` | path | yes | 0x-prefixed 20-byte hex address. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pool [#pool] ```http GET /pools/{address} ``` Pool identity: protocol, both currencies, fee and tick spacing, factory coordinate, embedded stats. | Parameter | In | Required | Notes | | --------- | ---- | -------- | -------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | Pool ATH [#pool-ath] ```http GET /pools/{address}/ath ``` All-time high price for the pool. | Parameter | In | Required | Notes | | --------- | ---- | -------- | -------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | Pool ATL [#pool-atl] ```http GET /pools/{address}/atl ``` All-time low, same shape. | Parameter | In | Required | Notes | | --------- | ---- | -------- | -------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | Pool Liquidity [#pool-liquidity] ```http GET /pools/{address}/liquidity ``` Exact protocol-native liquidity: V2 reserves, or V3 active depth at the current tick; plus `liquidityUsd` (V2 reserves, or V3 current-tick-spacing range amounts, each side through its own USD mark; null with a reason when a side is unpriced) and `usdMarks`. | Parameter | In | Required | Notes | | --------- | ---- | -------- | -------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | Pool OHLCV [#pool-ohlcv] ```http GET /pools/{address}/ohlcv ``` 1m/1h/1d candles with two-sided volume and rational OHLC. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | | `frame` | query | yes | `1s`, `30s`, `1m`, `1h`, or `1d` candle width. `1s`/`30s` rows exist only for a pool with durable fine-candle retention; see the response's own `fineSeriesAvailable`. | | `from` | query | yes | Inclusive start of the unix-second range the candle series covers, aligned down to its `frame`'s own bucket width. Must be `<= to`. | | `to` | query | yes | Inclusive end of the unix-second range the candle series covers, aligned down to its `frame`'s own bucket width. The requested span is capped at a fixed number of candle buckets. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pool Stats [#pool-stats] ```http GET /pools/{address}/stats ``` Rolling 5m/1h/4h/24h statistics for the pool. | Parameter | In | Required | Notes | | --------- | ---- | -------- | -------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | Pool Swaps [#pool-swaps] ```http GET /pools/{address}/swaps ``` Exact swaps for the pool with full block, transaction and log coordinates. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pool Ticks [#pool-ticks] ```http GET /pools/{address}/ticks ``` Per-trade tick rows enriched with transaction context. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `address` | path | yes | 0x-prefixed 20-byte hex address. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pool Bars [#pool-bars] ```http GET /pools/{address}/ticks/bars ``` N-trade or N-volume bars folded over the tick sequence. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `address` | path | yes | 0x-prefixed 20-byte hex address. | | `rule` | query | yes | `rule` is exactly `trade` or `volume`; `size` is its decimal-string threshold: a plain trade count for `rule=trade`, an exact base-unit quote quantity for `rule=volume` (large enough that a plain integer query type would not always hold it). The cursor is the same tick coordinate the swap and tick routes use, since a bar page resumes the identical underlying walk. | | `size` | query | yes | `rule` is exactly `trade` or `volume`; `size` is its decimal-string threshold: a plain trade count for `rule=trade`, an exact base-unit quote quantity for `rule=volume` (large enough that a plain integer query type would not always hold it). The cursor is the same tick coordinate the swap and tick routes use, since a bar page resumes the identical underlying walk. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | New Pools [#new-pools] ```http GET /pools/new ``` Newest-first feed of registered pools, by creation coordinate. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pool Search [#pool-search] ```http GET /pools/search ``` Bounded, filtered pool discovery anchored on one currency, in pool-identity order by default (`sort=pool_identity`). `sort=volume_24h` (requires `token`, descending only) ranks the token's markets by trailing-24h volume exactly as `/tokens/{address}/pools/ranked` does (quote-native under `quote`, else USD with unpriced pools last), with the same refinement filters and `allowScan` rule; rows add `rank`, `quoteAsset`, `rankedVolume24hQuote`, `rankedVolume24hUsd`, and the page adds `rankingBasis`, `membership` and `usdMarks`. `sort=liquidity` is refused (`400`); the USD-liquidity ranking is `/tokens/{address}/pools/ranked?sort=liquidity`. | Parameter | In | Required | Notes | | -------------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `allowScan` | query | no | Required only when a refinement filter (`fee_tier`, `protocol`, `created_from`, `created_to`) makes the indexed walk examine rows that are not returned. An unfiltered anchor-currency page and an unfiltered `token`+`quote` pair page are both indexed. | | `token` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `quote` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `fee_tier` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `protocol` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `factory` | query | no | Always rejected with a `400`: this store does not retain which factory emitted a pool's identity, so there is no value to filter or report on. The field exists only so the rejection is specific rather than a generic "unknown field" error. Supported filters: `token`, `quote`, `fee_tier`, `protocol`, `created_from`, `created_to`. | | `created_from` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `created_to` | query | no | `token`/`quote` name the pool's two currencies (either or both may be given; at least one is required as the anchor currency the walk is indexed on). `fee_tier`/`protocol`/`created_from`/`created_to` refine that walk. `factory` is not accepted; see its row below. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | V4 Pool [#v4-pool] ```http GET /pools/v4/{manager}/{pool_id} ``` V4 pool identity, keyed by manager address and pool id rather than a pool address. | Parameter | In | Required | Notes | | --------- | ---- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | V4 Pool Liquidity [#v4-pool-liquidity] ```http GET /pools/v4/{manager}/{pool_id}/liquidity ``` V4 liquidity observation, plus `liquidityUsd` as for V3. | Parameter | In | Required | Notes | | --------- | ---- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | V4 Pool OHLCV [#v4-pool-ohlcv] ```http GET /pools/v4/{manager}/{pool_id}/ohlcv ``` V4 candles. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | | `frame` | query | yes | `1s`, `30s`, `1m`, `1h`, or `1d` candle width. `1s`/`30s` rows exist only for a pool with durable fine-candle retention; see the response's own `fineSeriesAvailable`. | | `from` | query | yes | Inclusive start of the unix-second range the candle series covers, aligned down to its `frame`'s own bucket width. Must be `<= to`. | | `to` | query | yes | Inclusive end of the unix-second range the candle series covers, aligned down to its `frame`'s own bucket width. The requested span is capped at a fixed number of candle buckets. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | V4 Pool Stats [#v4-pool-stats] ```http GET /pools/v4/{manager}/{pool_id}/stats ``` V4 rolling-window statistics. | Parameter | In | Required | Notes | | --------- | ---- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | V4 Pool Swaps [#v4-pool-swaps] ```http GET /pools/v4/{manager}/{pool_id}/swaps ``` V4 swaps. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | V4 Pool Ticks [#v4-pool-ticks] ```http GET /pools/v4/{manager}/{pool_id}/ticks ``` V4 per-trade ticks. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | V4 Pool Bars [#v4-pool-bars] ```http GET /pools/v4/{manager}/{pool_id}/ticks/bars ``` V4 trade or volume bars. | Parameter | In | Required | Notes | | --------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `manager` | path | yes | The V4 pool manager contract. Many distinct pools share one manager address: this alone does not identify a pool, pair it with `pool_id` below. Obtain both together from a real pool's `contract`/`poolId` fields via `GET /pools/search` or `GET /pools/new` (filter or scan for `"protocol":"v4"`); a V4 manager address cannot be looked up through the plain `GET /pools/{address}` route. | | `pool_id` | path | yes | Stored V4 pool identity key, hex. Obtain a real one from `pools/search` or `pools/new`'s `poolId` field, paired with the same pool's `contract` as `manager` above: V4 pools cannot be looked up via the plain `/pools/{address}` route. | | `rule` | query | yes | `rule` is exactly `trade` or `volume`; `size` is its decimal-string threshold: a plain trade count for `rule=trade`, an exact base-unit quote quantity for `rule=volume` (large enough that a plain integer query type would not always hold it). The cursor is the same tick coordinate the swap and tick routes use, since a bar page resumes the identical underlying walk. | | `size` | query | yes | `rule` is exactly `trade` or `volume`; `size` is its decimal-string threshold: a plain trade count for `rule=trade`, an exact base-unit quote quantity for `rule=volume` (large enough that a plain integer query type would not always hold it). The cursor is the same tick coordinate the swap and tick routes use, since a bar page resumes the identical underlying walk. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. | Pools By Token [#pools-by-token] ```http GET /tokens/{currency}/pools ``` Pools where this address is one of the two currencies, in pool-identity order (not a ranking; includes pools where the address is the QUOTE). For a volume-ranked list of the token's own markets use `/pools/ranked`. | Parameter | In | Required | Notes | | ---------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `currency` | path | yes | 0x-prefixed 20-byte hex address. | | `cursor` | query | no | Opaque page cursor. See [Pagination](/docs/indexer/api). | | `limit` | query | no | Page row cap. See [Pagination](/docs/indexer/api) for the shared contract; the exact default and maximum for this route are on the schema. | | `order` | query | no | Sort direction: this route's accepted values and default are on the schema (`enum`/`default`); a route whose backing index has no reverse walk accepts only `asc`. See [Pagination](/docs/indexer/api) for the shared contract. |