Skip to content
Pools

Discover pools by mint

GET
/v1/pools

Lists pools discovered by the configured grapl indexer. Supply quoteMint to find a direct pair. Empty results return 200. Catalog inclusion is not a quote or an execution guarantee; use /v1/swap/quote to compare supported pools for an amount.

Authorization

IntegrationKey
headerx-api-key<token>

Integration credential issued to your team. All team keys share the same request quota.

Query Parameters

mint*string

Find indexed grapl pools containing this SPL mint on either side.

Match^[1-9A-HJ-NP-Za-km-z]{32,44}$
Formatsolana-address
quoteMint?string

Optional second mint. Restricts discovery to the direct pair, in either order.

Match^[1-9A-HJ-NP-Za-km-z]{32,44}$
Formatsolana-address
limit?integer

Maximum pools per page, ordered by pool address.

Range1 <= value <= 100
Default20
cursor?string

Exclusive pool address cursor returned as nextCursor. Pagination is a live catalog view.

Match^[1-9A-HJ-NP-Za-km-z]{32,44}$
Formatsolana-address

Response Body

Successful request

application/json
  1. response
success*true
Value intrue
data*
curl -X GET '{GRAPL_API_ORIGIN}/v1/pools?mint=string' \  -H 'x-api-key: {GRAPL_API_KEY}'
Empty

The interactive playground is unavailable because no service origin is configured. Replace {GRAPL_API_ORIGIN} and {GRAPL_API_KEY} with your deployment values, and provide valid values for the schema-generated request inputs before running a sample. Responses without captured examples show Empty; the response schema remains available.

All public endpoints · OpenAPI JSON