# Astroport DEX On-Chain API > Live data from Astroport, the leading Cosmos automated-market-maker DEX (deployed on Neutron, Terra and more). Read every liquidity pool (pool type, paired assets with USD price, total liquidity USD, 24h volume and LP fees, staked liquidity, yield/APR breakdown); the full detail of a single pool by address; the listed tokens with USD price and liquidity; and the global DEX stats (total liquidity, 24h swap count and volume, per-chain breakdown, ASTRO token supply). The Astroport / Cosmos-DEX / AMM-liquidity layer for DeFi dashboards, swap routers and yield trackers. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/astroport-api/..." ``` ## Pricing - **Free** (Free) — 3,300 calls/Mo, 2 req/s - **Basic** ($17/Mo) — 73,000 calls/Mo, 5 req/s - **Pro** ($45/Mo) — 272,000 calls/Mo, 15 req/s - **Business** ($97/Mo) — 985,000 calls/Mo, 40 req/s ## Endpoints ### DEX #### `GET /v1/pool` — Full detail for one pool **Parameters:** - `address` (query, required, string) — Pool contract address Example: `neutron1nfns3ck2ykrs0fknckrzd9728cyf77devuzernhwcwrdxw7ssk2s3tjf8r` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/astroport-api/v1/pool?address=neutron1nfns3ck2ykrs0fknckrzd9728cyf77devuzernhwcwrdxw7ssk2s3tjf8r" ``` **Response:** ```json { "data": { "dex": "Astroport", "pool": { "apr": 0.00022453, "assets": [ { "denom": "ibc/B559A80D62249C8AA07A380E2A2BEA6E5CA9A6F079C912C3A9E9B494105E4F81", "symbol": "USDC", "price_usd": 0.999755 }, { "denom": "factory/neutron1k6hr0f83e7un2wjf29cspk7j69jrnskk65k3ek2nj9dztrlzpj6q00rtsa/udatom", "symbol": "dATOM", "price_usd": 2.88229045 } ], "chain_id": "neutron-1", "pool_type": "concentrated_duality_orderbook", "deregistered": false, "pool_address": "neutron1nfns3ck2ykrs0fknckrzd9728cyf77devuzernhwcwrdxw7ssk2s3tjf8r", "apr_breakdown": { "astro": 0, "external": 0, "pool_fees": 0.00022453 }, "day_volume_usd": 2997.45, "day_lp_fees_usd": 2.8663, "total_liquidity_usd": 4659310, "staked_liquidity_usd": 54342.2 } }, "meta": { "timestamp": "2026-06-15T02:09:59.852Z", "request_id": "3e29b0bc-cb34-4eba-a944-ad900fb19330" }, "status": "ok", "message": "Pool retrieved successfully", "success": true } ``` #### `GET /v1/pools` — All liquidity pools **Parameters:** - `sort` (query, optional, string) — Sort field: tvl, volume or fees Example: `tvl` - `limit` (query, optional, string) — Number of pools (1-200) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/astroport-api/v1/pools?sort=tvl&limit=20" ``` **Response:** ```json { "data": { "dex": "Astroport", "sort": "tvl", "count": 20, "pools": [ { "apr": 0.00022453, "assets": [ { "denom": "ibc/B559A80D62249C8AA07A380E2A2BEA6E5CA9A6F079C912C3A9E9B494105E4F81", "symbol": "USDC", "price_usd": 0.999755 }, { "denom": "factory/neutron1k6hr0f83e7un2wjf29cspk7j69jrnskk65k3ek2nj9dztrlzpj6q00rtsa/udatom", "symbol": "dATOM", "price_usd": 2.88229045 } ], "chain_id": "neutron-1", "pool_type": "concentrated_duality_orderbook", "deregistered": false, "pool_address": "neutron1nfns3ck2ykrs0fknckrzd9728cyf77devuzernhwcwrdxw7ssk2s3tjf8r", "apr_breakdown": { "astro": 0, "external": 0, "pool_fees": 0.00022453 }, "day_volume_usd": 2997.45, "day_lp_fees_usd": 2.8663, "total_liquidity_usd": 4659310, "staked_liquidity_usd": 54342.2 }, { "apr": 0, "assets": [ { "denom": "ibc/F082B65C88E4B6D5EF1DB243CDA1D331D002759E938A0F5CD3FFDC5D53B3E349", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/stats` — Global DEX stats **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/astroport-api/v1/stats" ``` **Response:** ```json { "data": { "dex": "Astroport", "chains": { "neutron-1": { "pools_count": 537, "day_volume_usd": 30411.66, "day_lp_fees_usd": 28.8932, "total_liquidity_usd": 5212293.59 }, "phoenix-1": { "pools_count": 275, "day_volume_usd": 103525.21, "day_lp_fees_usd": 83.2213, "total_liquidity_usd": 4443020.95 } }, "astro_token": { "total_supply": 1000000000000000, "circulating_supply": 519647010625502 }, "pools_count": 812, "day_volume_usd": 133936.87, "day_lp_fees_usd": 112.1145, "day_swaps_count": 4179, "total_liquidity_usd": 9655314.54 }, "meta": { "timestamp": "2026-06-15T02:10:00.522Z", "request_id": "b0a60784-1789-4f31-9ea0-0cb81fb865dc" }, "status": "ok", "message": "Stats retrieved successfully", "success": true } ``` #### `GET /v1/tokens` — Listed tokens with USD price & liquidity **Parameters:** - `limit` (query, optional, string) — Number of tokens (1-300) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/astroport-api/v1/tokens?limit=50" ``` **Response:** ```json { "data": { "dex": "Astroport", "count": 50, "tokens": [ { "denom": "ibc/B559A80D62249C8AA07A380E2A2BEA6E5CA9A6F079C912C3A9E9B494105E4F81", "symbol": "USDC", "chain_id": "neutron-1", "decimals": 6, "price_usd": 0.999755, "day_volume_usd": 25259.41, "total_liquidity_usd": 3037393.82 }, { "denom": "factory/neutron1k6hr0f83e7un2wjf29cspk7j69jrnskk65k3ek2nj9dztrlzpj6q00rtsa/udatom", "symbol": "dATOM", "chain_id": "neutron-1", "decimals": 6, "price_usd": 2.8822904483, "day_volume_usd": 6648.58, "total_liquidity_usd": 2343201.79 }, { "denom": "ibc/2CB87BCE0937B1D1DFCEE79BE4501AAF3C265E923509AEAC410AD85D27F35130", "symbol": "DYDX", "chain_id": "neutron-1", "decimals": 18, "price_usd": 0.1227222686, "day_volume_usd": 17515.7, "total_liquidity_usd": 105262.66 }, { "denom": "untrn", "symbol": "NTRN", "chain_id": "neutron-1", "decimals": 6, "price_usd": 0.00104616, "day_volume_usd": 3613.47, "total_liquidity_usd": 70587.21 }, …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — DEX metadata & endpoint guide **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/astroport-api/v1/meta" ``` **Response:** ```json { "data": { "dex": "Astroport (Cosmos AMM)", "chains": [ "neutron-1", "phoenix-1" ], "source": "Astroport public API (app.astroport.fi), keyless", "examples": { "pools": "/v1/pools?sort=tvl&limit=20", "stats": "/v1/stats", "tokens": "/v1/tokens?limit=50" }, "endpoints": { "/v1/pool": "full detail for one pool (address)", "/v1/pools": "all liquidity pools (assets, TVL, 24h volume/fees, APR; sort=tvl|volume|fees, limit)", "/v1/stats": "global DEX stats (TVL, swaps, fees, per-chain, ASTRO token)", "/v1/tokens": "listed tokens with USD price and liquidity (limit)" }, "cache_ttl_ms": 30000 }, "meta": { "timestamp": "2026-06-15T02:10:00.894Z", "request_id": "4722d13d-94ed-4846-a69b-ccdcc7f4d544" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/astroport-api OpenAPI spec: https://www.oanor.com/api/astroport-api/openapi.json