Skip to content
GET /v1/pools

Browse liquidity pools with reserves, fee, shares, trustlines

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/stellarpools-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/stellarpools-api/v1/pools" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/stellarpools-api/v1/pools", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/stellarpools-api/v1/pools");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/stellarpools-api/v1/pools",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Stellar liquidity pools (native constant-product AMMs). Each has two reserves, a fee (fee_pct), the number of pool shares and trustlines (participants).",
        "count": 20,
        "pools": [
            {
                "id": "ffffe478b19c0d27c19fecdf36b6b60fefc563e1806109a58b86b4138abd085a",
                "type": "constant_product",
                "fee_bp": 30,
                "fee_pct": 0.3,
                "reserves": [
                    {
                        "code": "LIBRE",
                        "asset": "LIBRE:GAYCCWKECNGDRHYU3UTREBD2XLC3CUQN6FV22TKM4WCQER3IWR7TF5CY",
                        "amount": "2493.4272764",
                        "issuer": "GAYCCWKECNGDRHYU3UTREBD2XLC3CUQN6FV22TKM4WCQER3IWR7TF5CY"
                    },
                    {
                        "code": "NFIUM",
                        "asset": "NFIUM:GD76B36XOOH432PICDIVEOD4RU7TEFJ5DZVA2C5MW5LKTSCARK45V3DB",
                        "amount": "2948385.4709963",
                        "issuer": "GD76B36XOOH432PICDIVEOD4RU7TEFJ5DZVA2C5MW5LKTSCARK45V3DB"
                    }
                ],
                "total_shares": "85559.0257965",
                "total_trustlines": 1,
                "last_modified_ledger": 63020560
            },
            {
                "id": "ffff7fe3743b3c63b12e80f22aed5e8799aa986e25fe155a19277b660d547e71",
                "type": "constant_product",
                "fee_bp": 30,
                "fee_pct": 0.3,
                "reserves": [
                    {
                        "code": "XLM",
                        "asset": "XLM",
                        "amount": "1.6374287",
                        "issuer": null
                    },
                    {
                        "code": "AAVE",
                        "asset": "AAVE:GDTGN34MKUEO4BTJET4SX6TCRQ72FS2TPDNFO6JDXXVL4PNBSREHD2D5",
                        "amount": "157892432.1726389",
                        "issuer": "GDTGN34MKUEO4BTJET4SX6TCRQ72FS2TPDNFO6JDXXVL4PNBSREHD2D5"
                    }
                ],
                "total_shares": "15653.2744178",
                "total_trustlines": 1,
                "last_modified_ledger": 60027687
            },
            {
                "id": "fffe063e6fa6d51317dc3fb825663afe63c886d7b60f26a67559e4efbe52ead0",
                "type": "constant_product",
                "fee_bp": 30,
                "fee_pct": 0.3,
                "reserves": [
                    {
                        "code": "EURC",
                        "asset": "EURC:GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2",
                        "amount": "286.6907329",
                        "issuer": "GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2"
                    },
                    {
                        "code": "NAFU",
                        "asset": "NAFU:GBHA4FGPHX7KURMP7CZU7SQ2UOAGTAQ22SCHPK5P5XCQHZXCSVXQJFYB",
                        "am
…