List Liquidity Pools

This endpoint lists all available liquidity pools.

This method will use 20 Compute Units.

---

Reference: Here

List Liquidity Pools

get

This endpoint lists all available liquidity pools.

Query parameters

reservesanyOptional

Comma-separated list of assets in canonical form (Code:IssuerAccountID), to only include liquidity pools which have reserves matching all listed assets.

accountanyOptional

A Stellar account ID, to only include liquidity pools in which this account is participating in (i.e. holds pool shares to).

cursorintegerOptional

A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.

Example: 6606617478959105

orderstring · enumOptional

A designation of the order in which records should appear. Options include asc (ascending) or desc (descending). If this argument isn’t set, it defaults to asc.

Possible values:

limitintegerOptional

The maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.

Example: 10

Responses

200

Success

application/json

Responseall of

get

HTTPcURLJavaScriptPython

GET /v1/<YOUR_API_KEY_HERE>/liquidity_pools HTTP/1.1
Host: mainnet.stellar.validationcloud.io
Accept: */*

200

Success

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/liquidity_pools?cursor=&limit=10&order=asc"
    },
    "next": {
      "href": "https://horizon-testnet.stellar.org/liquidity_pools?cursor=66835-00000000c582697b67cbec7f9ce64f4dc67bfb2bfd26318bb9f964f4d70e3f41f650b1e6&limit=10&order=asc"
    },
    "prev": {
      "href": "https://horizon-testnet.stellar.org/liquidity_pools?cursor=38888-00000000929b20b72e5890ab51c24f1cc46fa01c4f318d8d33367d24dd614cfdf5491072&limit=10&order=desc"
    }
  },
  "_embedded": {
    "records": [
      {
        "id": "67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9",
        "paging_token": "113725249324879873",
        "fee_bp": 30,
        "type": "constant_product",
        "total_trustlines": "300",
        "total_shares": "5000",
        "reserves": [
          {
            "amount": "1000.0000005",
            "asset": "EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
          },
          {
            "amount": "2000.0000000",
            "asset": "PHP:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
          }
        ]
      },
      {
        "id": "14be5a5b3d3f5e1e74380ab0a3bf9c172b7246fdf7753b172cbacd4d66143c08",
        "paging_token": "113725249324879874",
        "fee_bp": 30,
        "type": "constant_product",
        "total_trustlines": "200",
        "total_shares": "3500",
        "reserves": [
          {
            "amount": "1000.0000005",
            "asset": "EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
          },
          {
            "amount": "1200.0000000",
            "asset": "USDC:GC5W3BH2MQRQK2H4A6LP3SXDSAAY2W2W64OWKKVNQIAOVWSAHFDEUSDC"
          }
        ]
      }
    ]
  }
}