Introduction
The Radix Gateway API is a JSON-based HTTP API layer exposed by the Babylon Radix Gateway that enables dApp frontends, wallets, and explorers to efficiently query current and historical ledger state, submit transactions, and stream network activity — all without running a full node.
The Gateway sits between dApp clients and the Radix Core API (which communicates directly with validator nodes), providing a developer-friendly abstraction layer with features like cursor-based pagination, historical state browsing, and consistent reads.
API Groups
The Gateway API is organised into five main groups, all using HTTP POST:
- Status (
/status/*) — gateway and network configuration, health checks - Transaction (
/transaction/*) — construction metadata, preview (dry-run), submission, and status tracking - Stream (
/stream/*) — read committed transactions with filters (by account, resource, badge, event type, manifest class) - State (
/state/*) — query current and historical entity state (accounts, components, resources, validators, key-value stores, NFT data) - Statistics (
/statistics/*) — network statistics, validator uptime
Additional Extensions endpoints provide specialised queries like resource holder lists and role requirement lookups.
Developer Usage
Most Radix dApp developers interact with the Gateway through the TypeScript SDK. If using the Radix dApp Toolkit, the Gateway SDK is already integrated and does not need separate import.
Key features for developers:
- Historical state — browse entity state at any past ledger version via
at_ledger_state - Consistent reads — pin multiple queries to the same ledger version snapshot
- Opt-in properties — reduce bandwidth by requesting only needed fields
- Transaction preview — dry-run manifests before submission to check outcomes
Providers
The official Radix gateway is the primary provider, but third-party services including RadixAPI and NowNodes also offer Gateway API access for redundancy and geographic distribution.
External Links
- Gateway API Reference — Redoc Documentation
- Gateway SDK — Radix Documentation
- Network APIs — Radix Documentation
- babylon-gateway — GitHub Repository
Connect your wallet to join the discussion.