Get pools info

Read Aquarius pool data with the official SDK — pools for a pair, reserves, share balances, and an account's positions. No signer required.

Every read on this page works without a signer — construct the client with a network alone. Pool data is also displayed in the app, on each pool's page.

This page uses the official SDKs. For the raw read functions — get_pools, get_info, get_reserves, and the rest — see Router & pool contracts; the REST alternative is the Backend API.

Pools for a pair

Python

from aquarius import AquariusClient, Asset, XLM

AQUA = Asset.classic("AQUA", "GBNZILSTVQZ4R7IKQDGHYGY2QXL5QOFJYQMXPKWRRM5PAV7Y4M67AQUA")

aqua = AquariusClient(network="mainnet")   # reads need no signer

for pool in aqua.pools_for_pair(XLM, AQUA):
    print(pool.type, pool.fee_bps, pool.address, pool.token_labels)

JavaScript

import { AquariusClient, Asset, XLM } from "@aquariusdefi/sdk";

const AQUA = Asset.classic("AQUA", "GBNZILSTVQZ4R7IKQDGHYGY2QXL5QOFJYQMXPKWRRM5PAV7Y4M67AQUA");

const aqua = new AquariusClient({ network: "mainnet" });   // reads need no signer

for (const pool of await aqua.pools.forPair(XLM, AQUA)) {
  console.log(pool.type, pool.feeBps, pool.address, pool.tokenLabels);
}

Each Pool carries:

Attribute	Meaning
type	volatile, stable, or concentrated
fee_bps / feeBps	Swap fee in basis points (30 = 0.3%)
address	The pool's contract address
pool_hash / poolHash	The pool hash identifying it inside the router
tokens	Token contract IDs, in the contract's sorted order
token_labels / tokenLabels	Human-readable names, for example native, AQUA:GBNZ…

Reserves and share totals

Python

pool = aqua.pools_for_pair(XLM, AQUA)[0]

pool.reserves()               # base units per token, in sorted-token order
pool.total_shares()           # total pool share supply
pool.share_balance("G...")    # one account's shares
pool.pending_rewards("G...")  # one account's accrued AQUA, in stroops

JavaScript

const pool = (await aqua.pools.forPair(XLM, AQUA))[0];

await pool.reserves();               // base units per token, in sorted-token order
await pool.totalShares();            // total pool share supply
await pool.shareBalance("G...");     // one account's shares
await pool.pendingRewards("G...");   // one account's accrued AQUA, in stroops

Positions

Every pool where an account holds shares, in one call:

Python

for position in aqua.positions("G..."):
    print(position.pool.type, position.pool.fee_bps, position.shares)

JavaScript

for (const position of await aqua.positions("G...")) {
  console.log(position.pool.type, position.pool.feeBps, position.shares);
}

Positions are backed by the indexer: a deposit that confirmed moments ago can take a few seconds to appear. Share amounts are read from the chain.

The REST alternative

For dashboards and indexers that want pool data without touching the chain, the Backend API serves the same information over REST — pool lists with type and fee, an account's pools, and volume statistics. The full machine-readable spec is at amm-api.aqua.network/api/schema/redoc.