Hanzo AI
OpenapiMarket

List pools

Answers the automated market makers on one chain: their two tokens, their fee tier, and what has moved through each.

GET /v1/market/pools

Addresshttps://api.hanzo.ai/v1/market/pools
MethodGET
Operationget_market_pools
AuthAuthorization: Bearer $HANZO_API_KEY

Answers the automated market makers on one chain: their two tokens, their fee tier, and what has moved through each.

The two price fields on a pool are the ratio its own reserves stand at, as the indexer computed them. They are not a price ON either token and not a mark: nothing here derives one, ranks the pools, or names a route through them.

A chain with no market maker deployed answers read with no pools. That is the chain's real condition, and it is deliberately not the same answer as an indexer that could not be asked.

Request

1 field.

FieldInTypeRequiredDescription
chainquerystringChain is the chain's slug — cchain, zoo — as chains reports it.

Response

StatusBodyMeaning
200market.Poolsok
defaultproblem-detailsrefused

200 body — 22 fields.

FieldInTypeAlwaysDescription
chainbodystring
poolsbodymarket.Pool[]Pools is [] where the chain has none and null where the read failed.
pools[].atbodystringAt is the pool contract's address, lowercase.
pools[].countbodyinteger (int64)
pools[].feebodyinteger (int64)Fee is the pool's tier in hundredths of a basis point — 3000 is 0.3%.
pools[].lockedbodystring
pools[].token0bodymarket.Token
pools[].token0.atbodystringAt is the token's contract address, lowercase.
pools[].token0.decimalsbodyinteger (int64)
pools[].token0.namebodystring
pools[].token0.symbolbodystring
pools[].token0PricebodystringToken0Price is token1 per token0, and Token1Price its reciprocal, both as the indexer computed them.
pools[].token1bodymarket.Token
pools[].token1.atbodystringAt is the token's contract address, lowercase.
pools[].token1.decimalsbodyinteger (int64)
pools[].token1.namebodystring
pools[].token1.symbolbodystring
pools[].token1Pricebodystring
pools[].volumebodystring
reachbodymarket.Reach
reach.atbodystringAt is read, unconfigured, unreachable or refused.
reach.whybodystringWhy is the upstream's own words, on Unreachable and Refused, and empty otherwise.

Failure carries the platform error shape — see Errors.

Examples

hanzo market pools

Market API · All Hanzo APIs · Interactive reference

How is this guide?

On this page