Build · EXPANSION API

The whole network, behind one REST API.

EXPANSION is the RESTful API surface for the Bantu blockchain. Every account, every ledger, every transaction, every operation, every asset — readable in seconds, streamable in real time. No authentication required for reads.

Mainnet base URL

https://expansion.bantu.network

Production traffic. Real value flows here. Use for live integrations.

Testnet base URL

https://expansion-testnet.bantu.network

Free testnet for development. Friendbot tops you up with XBN-test.

//Resources

Every endpoint, organized by resource.

Accounts

Query account state, balances, signers, trustlines, sequence number, home domain.

GET /accounts/{account_id}
GET /accounts/{account_id}/transactions
GET /accounts/{account_id}/operations
GET /accounts/{account_id}/payments
GET /accounts/{account_id}/effects
GET /accounts/{account_id}/offers
GET /accounts/{account_id}/trades

Ledgers

Read finalized ledgers (blocks). Sequence number, close time, total transactions, total coins, base fee.

GET /ledgers
GET /ledgers/{sequence}
GET /ledgers/{sequence}/transactions
GET /ledgers/{sequence}/operations
GET /ledgers/{sequence}/payments
GET /ledgers/{sequence}/effects

Transactions

Inspect or submit transactions. Each transaction is a list of operations, signed by the source account.

GET /transactions
GET /transactions/{tx_hash}
POST /transactions   (submit a signed envelope)
GET /transactions/{tx_hash}/operations
GET /transactions/{tx_hash}/effects

Operations

Granular ledger events — payments, asset issuance, multisig setup, trustline changes, path payments, etc.

GET /operations
GET /operations/{op_id}
GET /operations/{op_id}/effects

Payments

Payment-type operations specifically (a subset of operations). Useful for wallet history and merchant integration.

GET /payments

Assets

Every issued asset on the chain — symbol, issuer, supply, holders. The directory of every token on Bantu.

GET /assets
GET /assets?asset_code={CODE}
GET /assets?asset_issuer={G_ADDRESS}

Order book & Trades

The built-in DEX. Inspect bids/asks for any asset pair, query trade history.

GET /order_book?selling_asset_type=...&buying_asset_type=...
GET /trades
GET /offers/{offer_id}

Effects

Every state change as a flat stream — account created, balance changed, trustline updated, signer added.

GET /effects
GET /effects?account_id=...

Streaming (SSE)

Most read endpoints support Server-Sent Events for real-time subscriptions. Append `Accept: text/event-stream`.

GET /transactions   Accept: text/event-stream
GET /ledgers        Accept: text/event-stream
GET /effects        Accept: text/event-stream

Pagination, common parameters.

cursor

string

The paging_token of the last record from the previous page. Omit for the first page.

order

asc | desc

Sort direction. Defaults to asc.

limit

1–200

Records per page. Defaults to 10.

Try a live call — no auth, no setup, paste this in your terminal.

Open Laboratory →GitHub →