Appearance
Pools
GET /v1/pools/
List Pools
http
GET https://api.lfj.dev/v1/pools/{chain}Authentication: x-lfj-api-key header.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
chain | path | avalanche | arbitrum | base | berachain | binance | ethereum | mantle | monad | solana | sonic | yes | |
pageSize | query | integer | Default: 20. Range: > 0, ≤ 100. | |
pageNum | query | integer | Default: 1. Range: > 0. | |
orderBy | query | liquidity | volume | name | Default: "volume". | |
filterBy | query | 1h | 1d | 7d | 14d | 30d | Default: "1d". | |
status | query | main | old | all | Default: "all". | |
version | query | v2.0 | v2.1 | v2.2 | all | Default: "all". | |
excludeLowVolumePools | query | boolean | Default: true. |
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | array of GetPair |
| 422 | Validation Error | HTTPValidationError |
Schemas
GetPair
| Field | Type | Required | Description |
|---|---|---|---|
pairAddress | string | yes | |
chain | avalanche | arbitrum | base | berachain | binance | ethereum | mantle | monad | solana | sonic | yes | |
name | string | yes | |
status | main | old | yes | |
version | v2.0 | v2.1 | v2.2 | yes | |
tokenX | TokenWrapper | yes | |
tokenY | TokenWrapper | yes | |
reserveX | number | yes | |
reserveY | number | yes | |
lbBinStep | integer | yes | |
lbBaseFeePct | number | yes | |
lbMaxFeePct | number | yes | |
activeBinId | integer | ||
liquidityUsd | number | yes | |
liquidityNative | string | yes | |
liquidityDepthMinus | number | yes | |
liquidityDepthPlus | number | yes | |
liquidityDepthTokenX | number | yes | |
liquidityDepthTokenY | number | yes | |
volumeUsd | number | yes | |
volumeNative | string | yes | |
feesUsd | number | yes | |
feesNative | string | yes | |
protocolSharePct | number |
TokenWrapper
| Field | Type | Required | Description |
|---|---|---|---|
address | string | yes | |
name | string | yes | |
symbol | string | yes | |
decimals | integer | yes | |
priceUsd | number | yes | |
priceNative | string | yes |
HTTPValidationError
| Field | Type | Required | Description |
|---|---|---|---|
detail | array of ValidationError |
ValidationError
| Field | Type | Required | Description |
|---|---|---|---|
loc | array of string | integer | yes | |
msg | string | yes | |
type | string | yes |
GET /v1/pools/{chain}/
Get Pool
http
GET https://api.lfj.dev/v1/pools/{chain}/{address}Authentication: x-lfj-api-key header.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
chain | path | avalanche | arbitrum | base | berachain | binance | ethereum | mantle | monad | solana | sonic | yes | |
address | path | string | yes | |
filterBy | query | 1h | 1d | 7d | 14d | 30d | Default: "1d". |
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | GetPair |
| 422 | Validation Error | HTTPValidationError |
Schemas
GetPair
| Field | Type | Required | Description |
|---|---|---|---|
pairAddress | string | yes | |
chain | avalanche | arbitrum | base | berachain | binance | ethereum | mantle | monad | solana | sonic | yes | |
name | string | yes | |
status | main | old | yes | |
version | v2.0 | v2.1 | v2.2 | yes | |
tokenX | TokenWrapper | yes | |
tokenY | TokenWrapper | yes | |
reserveX | number | yes | |
reserveY | number | yes | |
lbBinStep | integer | yes | |
lbBaseFeePct | number | yes | |
lbMaxFeePct | number | yes | |
activeBinId | integer | ||
liquidityUsd | number | yes | |
liquidityNative | string | yes | |
liquidityDepthMinus | number | yes | |
liquidityDepthPlus | number | yes | |
liquidityDepthTokenX | number | yes | |
liquidityDepthTokenY | number | yes | |
volumeUsd | number | yes | |
volumeNative | string | yes | |
feesUsd | number | yes | |
feesNative | string | yes | |
protocolSharePct | number |
TokenWrapper
| Field | Type | Required | Description |
|---|---|---|---|
address | string | yes | |
name | string | yes | |
symbol | string | yes | |
decimals | integer | yes | |
priceUsd | number | yes | |
priceNative | string | yes |
HTTPValidationError
| Field | Type | Required | Description |
|---|---|---|---|
detail | array of ValidationError |
ValidationError
| Field | Type | Required | Description |
|---|---|---|---|
loc | array of string | integer | yes | |
msg | string | yes | |
type | string | yes |