Construir · EXPANSION API

Toda a rede, por trás de uma API REST.

A EXPANSION é a superfície de API RESTful da blockchain Bantu. Cada conta, cada livro-razão, cada transação, cada operação, cada ativo — legível em segundos, transmissível em tempo real. Sem autenticação necessária para leituras.

URL base do mainnet

https://expansion.bantu.network

Tráfego de produção. O valor real flui aqui. Use para integrações em produção.

URL base do testnet

https://expansion-testnet.bantu.network

Testnet gratuito para desenvolvimento. O Friendbot recarrega-o com XBN-test.

//Recursos

Cada endpoint, organizado por recurso.

Contas

Consulte o estado da conta, saldos, signatários, trustlines, número de sequência, domínio de origem.

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

Livros-razão

Leia livros-razão finalizados (blocos). Número de sequência, hora de fecho, total de transações, total de moedas, taxa base.

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

Transações

Inspecione ou submeta transações. Cada transação é uma lista de operações, assinada pela conta de origem.

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

Operações

Eventos granulares do livro-razão — pagamentos, emissão de ativos, configuração multisig, alterações de trustline, pagamentos por caminho, etc.

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

Pagamentos

Operações do tipo pagamento especificamente (um subconjunto das operações). Útil para histórico de carteira e integração de comerciantes.

GET /payments

Ativos

Cada ativo emitido na cadeia — símbolo, emissor, oferta, detentores. O diretório de cada token na Bantu.

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

Livro de ordens & negociações

O DEX integrado. Inspecione ofertas de compra/venda para qualquer par de ativos, consulte o histórico de negociações.

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

Efeitos

Cada alteração de estado como um fluxo plano — conta criada, saldo alterado, trustline atualizada, signatário adicionado.

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

Transmissão (SSE)

A maioria dos endpoints de leitura suporta Server-Sent Events para subscrições em tempo real. Acrescente `Accept: text/event-stream`.

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

Paginação, parâmetros comuns.

cursor

string

O paging_token do último registo da página anterior. Omita para a primeira página.

order

asc | desc

Direção de ordenação. Por defeito asc.

limit

1–200

Registos por página. Por defeito 10.

Experimente uma chamada em direto — sem auth, sem configuração, cole isto no seu terminal.

Abrir Laboratory →GitHub →