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
}

Pools

List Pools

This endpoint provides a paginated list of all AMM pools with comprehensive filtering options. Each pool includes current state data, market metrics, and configuration details aggregated from multiple data sources.

Filtering Options

By Assets: Filter by specific asset pairs or individual assets
By Host: Filter pools created by specific hosts
By Volume: Minimum 24-hour trading volume threshold
By TVL: Minimum total value locked threshold
By Type: Filter by pool curve type (constant product, single-sided)

Sorting Options

Results can be sorted by:

Creation date (newest/oldest first)
24-hour volume (highest/lowest first)
Total value locked (highest/lowest first)

Performance Considerations

Results are paginated with configurable limits
Maximum 100 pools per request
Filters are applied at the database level for efficiency

Query Parameters

assetAAddress - Filter by asset A address
assetBAddress - Filter by asset B address
hostNames - 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)
minVolume24h - Minimum 24h volume in asset B
minTvl - Minimum TVL in asset B
curveTypes - Array of curve types to filter by
sort - Sort order for results
limit - Maximum number of pools to return (1-100)
offset - Number of pools to skip for pagination

Returns

200 OK with list of pools and total count
500 Internal Server Error if data retrieval fails

GET

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<int64> | null

Minimum 24h volume in asset B.

minTvl

integer<int64> | null

Minimum TVL in asset B.

curveTypes

string[]

Pool curve types to filter by.

sort

enum<string>

Sort order for results. Sort order for listing pools.

Available options:

CREATED_AT_DESC,

CREATED_AT_ASC,

UPDATED_AT_DESC,

UPDATED_AT_ASC,

VOLUME24H_DESC,

VOLUME24H_ASC,

TVL_DESC,

TVL_ASC

limit

integer<int32> | null

Maximum number of pools to return.

offset

integer<int64> | 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.

Show child attributes

pools.lpPublicKey

string

required

LP public key (pool identifier).

Example:

"0315299b3f9f4e2beb8576ea2bf72ea1bc741eb255bfc3f6387de4d47b5c05972d"

pools.hostFeeBps

integer<int32>

required

Host fee in basis points (from settlement DB).

Required range: 0 <= x <= 10000

Example:

100

pools.lpFeeBps

integer<int32>

required

LP fee rate in basis points.

Required range: 0 <= x <= 10000

Example:

30

pools.assetAAddress

string

required

Asset A token address.

Example:

"66471063147ab9f53515bf18d1cea9a8ad166840ba9de93d46018d7007426e17"

pools.assetBAddress

string

required

Asset B token address.

Example:

"020202020202020202020202020202020202020202020202020202020202020202"

pools.assetAReserve

string

required

Current reserve of asset A.

Example:

"1041999990"

pools.assetBReserve

string

required

Current reserve of asset B.

Example:

"496"

pools.currentPriceAInB

string

required

Current price of asset A in terms of asset B.

Example:

"0.00000004761904807256236"

pools.tvlAssetB

string

required

Total value locked in asset B.

Example:

"992"

pools.volume24hAssetB

string

required

24-hour volume in asset B.

Example:

"500"

pools.priceChangePercent24h

string

required

24-hour price change percentage.

Example:

"-5.25"

pools.createdAt

string

required

Creation timestamp.

Example:

"2025-01-15T10:09:58.09646Z"

pools.updatedAt

string

required

Last update timestamp.

Example:

"2025-01-15T12:30:45.12345Z"

pools.hostName

string | null

Host name (human-readable).

Example:

"my-cool-exchange"

pools.virtualReserveA

string | null

Virtual reserve A (for bonding curve calculations).

pools.virtualReserveB

string | null

Virtual reserve B (for bonding curve calculations).

pools.thresholdPct

integer<uint8> | null

Threshold percentage for graduation to constant product.

Required range: x >= 0

pools.curveType

string | null

Pool curve type.

Example:

"SINGLE_SIDED"

pools.initialReserveA

string

Initial reserve A for bonding curve (only for single-sided pools).

Example:

"1000000000"

pools.bondingProgressPercent

string

Bonding progress percentage (only for single-sided pools).

Example:

"15.5"

pools.graduationThresholdAmount

string

Graduation threshold amount in asset A for single-sided pools.

Example:

"800000000"

totalCount

integer<int64>

required

The total number of pools available.

Settlement Health Check (uses grpc.health.v1 Health/Check)

Create CP Pool

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

List Pools

Filtering Options

Sorting Options

Performance Considerations

Query Parameters

Returns

Query Parameters

Response