Discover pools by mint
Find indexed pools for a mint or direct pair, with explicit pagination.
Discover pools for a mint
GET /v1/pools?mint=<mint> lists indexed grapl pools containing a mint on either side. Add quoteMint=<other-mint> to restrict the list to a direct pair.
Results contain pools and nextCursor. Use limit (default 20, maximum 100) and pass the previous nextCursor as cursor. Ordering is by pool address. Pagination reads a live catalog, so a new pool inserted before your cursor appears when you restart the scan.
Each pool includes both mints, its address, base fee in parts per million, mode, native liquidity units, hook program and observed slot. liquidity is not TVL and is not comparable as a standalone ranking metric across prices or ranges. Discovery includes pools without liquidity and hook pools whose quote adapter is not installed.
Discovery and quote operations require x-api-key and each admitted request consumes one unit of the team's request quota, including subsequent validation or provider failures.
From catalog to execution
A listed pool may be empty or use a policy unsupported by HTTP quoting. Use direct-pool quotes to compare a complete requested amount. Pass the selected pool and explicit execution bounds into your SDK flow; discovery does not create, sign, or submit a transaction.
Use the configured API origin and x-api-key. The exact query fields and response shape are in API Reference.