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.
- 200
Success
- application/json
- Schema
- Example (from schema)
- ListLiquidityPools
Schema
_links object
self object
href linktemplated booleannext object
href linktemplated booleanprev object
href linktemplated boolean_embedded object
records object[]
Array [id stringpaging_token stringfee_bp uint32type stringtotal_trustlines stringtotal_shares stringreserves object
asset stringamount stringlast_modified_ledger stringlast_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"
}
]
}
]
}
}