List Liquidity Pools

This endpoint lists all available liquidity pools.

Query Parameters

• reserves

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

• account

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

• cursor integer

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

• order string

  Possible values: [asc, desc]

  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.

• limit integer

  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.

Responses

• 200

---

Success

application/json

• Schema
• Example (from schema)
• ListLiquidityPools

---

Schema

• _links object

  self object

  href link

  templated boolean

  next object

  href link

  templated boolean

  prev object

  href link

  templated boolean
• _embedded object

  records object[]

  Array [

  id string

  paging_token string

  fee_bp uint32

  type string

  total_trustlines string

  total_shares string

  reserves object

  asset string

  amount string

  last_modified_ledger string

  last_modified_time string

  ]

{
  "_links": {
    "self": {
      "href": "string",
      "templated": true
    },
    "next": {
      "href": "string",
      "templated": true
    },
    "prev": {
      "href": "string",
      "templated": true
    }
  },
  "_embedded": {
    "records": [
      {
        "id": "string",
        "paging_token": "string",
        "fee_bp": 0,
        "type": "string",
        "total_trustlines": "string",
        "total_shares": "string",
        "reserves": {
          "asset": "string",
          "amount": "string"
        },
        "last_modified_ledger": "string",
        "last_modified_time": "string"
      }
    ]
  }
}

{
  "_links": {
    "self": {
      "href": "https://horizon.stellar.org/liquidity_pools?cursor=&limit=10&order=asc"
    },
    "next": {
      "href": "https://horizon.stellar.org/liquidity_pools?cursor=66835-00000000c582697b67cbec7f9ce64f4dc67bfb2bfd26318bb9f964f4d70e3f41f650b1e6&limit=10&order=asc"
    },
    "prev": {
      "href": "https://horizon.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"
          }
        ]
      }
    ]
  }
}

Loading...