GET
/
v1
/
pools
List Pools
curl --request GET \
  --url https://api.amm.flashnet.xyz/v1/pools
{
  "pools": [
    {
      "assetAAddress": "66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17",
      "assetAReserve": "1041999990",
      "assetBAddress": "020202020202020202020202020202020202020202020202020202020202020202",
      "assetBReserve": "496",
      "bondingProgressPercent": "15.5",
      "createdAt": "2025-01-15T10:09:58.09646Z",
      "currentPriceAInB": "0.00000004761904807256236",
      "curveType": "SINGLE_SIDED",
      "hostFeeBps": 100,
      "hostName": "my-cool-exchange",
      "initialReserveA": "1000000000",
      "lpFeeBps": 30,
      "lpPublicKey": "0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d",
      "priceChangePercent24h": "-5.25",
      "tvlAssetB": "992",
      "volume24hAssetB": "500"
    }
  ],
  "totalCount": 42
}

Query Parameters

assetAAddress
string | null

Asset A address. Defaults to all assets.

assetBAddress
string | null

Asset B address. Defaults to all assets.

hostNames
string[]

Host names to filter by. Can be passed as repeated parameters (e.g., hostNames=host1&hostNames=host2) or comma-separated (e.g., hostNames=host1,host2). Defaults to all hosts.

minVolume24h
integer | null

Minimum 24h volume in asset B.

minTvl
integer | null

Minimum TVL in asset B.

curveTypes
string[]

Pool curve types to filter by.

sort
enum<string>

Sort order for results.

Available options:
CREATED_AT_DESC,
CREATED_AT_ASC,
VOLUME24H_DESC,
VOLUME24H_ASC,
TVL_DESC,
TVL_ASC
limit
integer | null

Maximum number of pools to return.

offset
integer | null

Number of pools to skip before starting to collect the result set.

afterUpdatedAt
string | null

Return only pools that have had swaps after this timestamp (RFC3339).

Response

200
application/json

Pools retrieved successfully

Response type for listing pools, matching the OpenAPI specification.