# Pools

## GET /v1/pools/{chain}

> List Pools

```json
{"openapi":"3.0.2","info":{"title":"LFJ Dex API","version":"1.0.0"},"tags":[{"name":"Pools"}],"servers":[{"url":"https://api.lfj.dev"}],"security":[{"ApiKeyHeader":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-lfj-api-key"}},"schemas":{"Chain":{"title":"Chain","enum":["avalanche","arbitrum","base","berachain","binance","ethereum","mantle","monad","solana","sonic"],"type":"string","description":"An enumeration."},"PoolSortType":{"title":"PoolSortType","enum":["liquidity","volume","name"],"description":"An enumeration."},"FilterType":{"title":"FilterType","enum":["1h","1d","7d","14d","30d"],"description":"An enumeration."},"QueryStatus":{"title":"QueryStatus","enum":["main","old","all"],"type":"string","description":"An enumeration."},"dexbarn__schemas__v1__base__PairVersion":{"title":"PairVersion","enum":["v2.0","v2.1","v2.2","all"],"description":"An enumeration."},"GetPair":{"title":"GetPair","required":["pairAddress","chain","name","status","version","tokenX","tokenY","reserveX","reserveY","lbBinStep","lbBaseFeePct","lbMaxFeePct","liquidityUsd","liquidityNative","liquidityDepthMinus","liquidityDepthPlus","liquidityDepthTokenX","liquidityDepthTokenY","volumeUsd","volumeNative","feesUsd","feesNative"],"type":"object","properties":{"pairAddress":{"title":"Pairaddress","type":"string"},"chain":{"$ref":"#/components/schemas/Chain"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/PairStatus"},"version":{"$ref":"#/components/schemas/common__models__dex_v2__version__PairVersion"},"tokenX":{"$ref":"#/components/schemas/TokenWrapper"},"tokenY":{"$ref":"#/components/schemas/TokenWrapper"},"reserveX":{"title":"Reservex","type":"number"},"reserveY":{"title":"Reservey","type":"number"},"lbBinStep":{"title":"Lbbinstep","type":"integer"},"lbBaseFeePct":{"title":"Lbbasefeepct","type":"number"},"lbMaxFeePct":{"title":"Lbmaxfeepct","type":"number"},"activeBinId":{"title":"Activebinid","type":"integer"},"liquidityUsd":{"title":"Liquidityusd","type":"number"},"liquidityNative":{"title":"Liquiditynative","type":"string"},"liquidityDepthMinus":{"title":"Liquiditydepthminus","type":"number"},"liquidityDepthPlus":{"title":"Liquiditydepthplus","type":"number"},"liquidityDepthTokenX":{"title":"Liquiditydepthtokenx","type":"number"},"liquidityDepthTokenY":{"title":"Liquiditydepthtokeny","type":"number"},"volumeUsd":{"title":"Volumeusd","type":"number"},"volumeNative":{"title":"Volumenative","type":"string"},"feesUsd":{"title":"Feesusd","type":"number"},"feesNative":{"title":"Feesnative","type":"string"},"protocolSharePct":{"title":"Protocolsharepct","type":"number"}}},"PairStatus":{"title":"PairStatus","enum":["main","old"],"description":"An enumeration."},"common__models__dex_v2__version__PairVersion":{"title":"PairVersion","enum":["v2.0","v2.1","v2.2"],"description":"An enumeration."},"TokenWrapper":{"title":"TokenWrapper","required":["address","name","symbol","decimals","priceUsd","priceNative"],"type":"object","properties":{"address":{"title":"Address","type":"string"},"name":{"title":"Name","type":"string"},"symbol":{"title":"Symbol","type":"string"},"decimals":{"title":"Decimals","type":"integer"},"priceUsd":{"title":"Priceusd","type":"number"},"priceNative":{"title":"Pricenative","type":"string"}}},"HTTPValidationError":{"title":"HTTPValidationError","type":"object","properties":{"detail":{"title":"Detail","type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"title":"ValidationError","required":["loc","msg","type"],"type":"object","properties":{"loc":{"title":"Location","type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"}]}},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}}}}},"paths":{"/v1/pools/{chain}":{"get":{"tags":["Pools"],"summary":"List Pools","operationId":"list_pools_v1_pools__chain__get","parameters":[{"required":true,"schema":{"$ref":"#/components/schemas/Chain"},"name":"chain","in":"path"},{"required":false,"schema":{"title":"Pagesize","maximum":100,"exclusiveMinimum":0,"type":"integer","default":20},"name":"pageSize","in":"query"},{"required":false,"schema":{"title":"Pagenum","exclusiveMinimum":0,"type":"integer","default":1},"name":"pageNum","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/PoolSortType"}],"default":"volume"},"name":"orderBy","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/FilterType"}],"default":"1d"},"name":"filterBy","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/QueryStatus"}],"default":"all"},"name":"status","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/dexbarn__schemas__v1__base__PairVersion"}],"default":"all"},"name":"version","in":"query"},{"required":false,"schema":{"title":"Excludelowvolumepools","type":"boolean","default":true},"name":"excludeLowVolumePools","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response List Pools V1 Pools  Chain  Get","type":"array","items":{"$ref":"#/components/schemas/GetPair"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /v1/pools/{chain}/{address}

> Get Pool

```json
{"openapi":"3.0.2","info":{"title":"LFJ Dex API","version":"1.0.0"},"tags":[{"name":"Pools"}],"servers":[{"url":"https://api.lfj.dev"}],"security":[{"ApiKeyHeader":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-lfj-api-key"}},"schemas":{"Chain":{"title":"Chain","enum":["avalanche","arbitrum","base","berachain","binance","ethereum","mantle","monad","solana","sonic"],"type":"string","description":"An enumeration."},"FilterType":{"title":"FilterType","enum":["1h","1d","7d","14d","30d"],"description":"An enumeration."},"GetPair":{"title":"GetPair","required":["pairAddress","chain","name","status","version","tokenX","tokenY","reserveX","reserveY","lbBinStep","lbBaseFeePct","lbMaxFeePct","liquidityUsd","liquidityNative","liquidityDepthMinus","liquidityDepthPlus","liquidityDepthTokenX","liquidityDepthTokenY","volumeUsd","volumeNative","feesUsd","feesNative"],"type":"object","properties":{"pairAddress":{"title":"Pairaddress","type":"string"},"chain":{"$ref":"#/components/schemas/Chain"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/PairStatus"},"version":{"$ref":"#/components/schemas/common__models__dex_v2__version__PairVersion"},"tokenX":{"$ref":"#/components/schemas/TokenWrapper"},"tokenY":{"$ref":"#/components/schemas/TokenWrapper"},"reserveX":{"title":"Reservex","type":"number"},"reserveY":{"title":"Reservey","type":"number"},"lbBinStep":{"title":"Lbbinstep","type":"integer"},"lbBaseFeePct":{"title":"Lbbasefeepct","type":"number"},"lbMaxFeePct":{"title":"Lbmaxfeepct","type":"number"},"activeBinId":{"title":"Activebinid","type":"integer"},"liquidityUsd":{"title":"Liquidityusd","type":"number"},"liquidityNative":{"title":"Liquiditynative","type":"string"},"liquidityDepthMinus":{"title":"Liquiditydepthminus","type":"number"},"liquidityDepthPlus":{"title":"Liquiditydepthplus","type":"number"},"liquidityDepthTokenX":{"title":"Liquiditydepthtokenx","type":"number"},"liquidityDepthTokenY":{"title":"Liquiditydepthtokeny","type":"number"},"volumeUsd":{"title":"Volumeusd","type":"number"},"volumeNative":{"title":"Volumenative","type":"string"},"feesUsd":{"title":"Feesusd","type":"number"},"feesNative":{"title":"Feesnative","type":"string"},"protocolSharePct":{"title":"Protocolsharepct","type":"number"}}},"PairStatus":{"title":"PairStatus","enum":["main","old"],"description":"An enumeration."},"common__models__dex_v2__version__PairVersion":{"title":"PairVersion","enum":["v2.0","v2.1","v2.2"],"description":"An enumeration."},"TokenWrapper":{"title":"TokenWrapper","required":["address","name","symbol","decimals","priceUsd","priceNative"],"type":"object","properties":{"address":{"title":"Address","type":"string"},"name":{"title":"Name","type":"string"},"symbol":{"title":"Symbol","type":"string"},"decimals":{"title":"Decimals","type":"integer"},"priceUsd":{"title":"Priceusd","type":"number"},"priceNative":{"title":"Pricenative","type":"string"}}},"HTTPValidationError":{"title":"HTTPValidationError","type":"object","properties":{"detail":{"title":"Detail","type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"title":"ValidationError","required":["loc","msg","type"],"type":"object","properties":{"loc":{"title":"Location","type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer"}]}},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}}}}},"paths":{"/v1/pools/{chain}/{address}":{"get":{"tags":["Pools"],"summary":"Get Pool","operationId":"get_pool_v1_pools__chain___address__get","parameters":[{"required":true,"schema":{"$ref":"#/components/schemas/Chain"},"name":"chain","in":"path"},{"required":true,"schema":{"title":"Address","type":"string"},"name":"address","in":"path"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/FilterType"}],"default":"1d"},"name":"filterBy","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPair"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.lfj.gg/lfj-dex-api/pools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.