Skip to main content
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",
      "thresholdPct": 80,
      "tvlAssetB": "992",
      "updatedAt": "2025-01-15T12:30:45.12345Z",
      "virtualReserveA": "1073741824",
      "virtualReserveB": "1073741824",
      "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,
UPDATED_AT_DESC,
UPDATED_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

Pools retrieved successfully

Response type for listing pools, matching the OpenAPI specification.

​
pools
object[]
required

The list of pool details.

​
totalCount
integer
required

The total number of pools available.