Use this page to pick the right IXO API before you start building. It compares the six interfaces in one table: what each is for, what you typically call, whether it reads or writes, and where to find its authentication and hosts.
Two kinds of API
| Kind | What it is |
|---|---|
| Protocol gateways | Node-level interfaces to IXO Protocol modules. You submit and query chain state over JSON-RPC, or over REST through the gRPC gateway (Cosmos stack). You typically need a wallet or signer for writes. |
| Service APIs | Operator-hosted interfaces over indexed chain data, IXO Matrix, registry workflows or USSD sessions. Authentication and base URLs are specific to each deployment. Never assume one header works everywhere. |
Comparison
| API | Primary purpose | Typical operations | Read or write | Authentication and endpoints |
|---|---|---|---|---|
| Blockchain RPC API | Transactions, ABCI queries, Tendermint RPC | broadcast_tx_*, status, block, tx search | Read and write (tx) | Authentication matrix and Networks and endpoints |
| Blockchain REST API (gRPC gateway) | HTTP and JSON queries, and tx broadcast where exposed | Module REST paths, Swagger or OpenAPI per deployment | Read. Write depends on deployment | Same as RPC. Confirm with the node operator |
| IXO Blocksync GraphQL API | Indexed queries over chain-derived entities | GraphQL queries (subscriptions if enabled) | Read-only in the docs model | Service operator credentials |
| Matrix state bot API | Room state, ACLs and automation hooks for Matrix | Bot-specific HTTP endpoints | Read and write (room operations) | Service operator credentials |
| Registry API | Impact Hub Registry application workflows | CRUD-style registry operations per spec | Read and write (per spec) | Often Basic or bearer. Confirm in the Authentication matrix |
| USSD gateway API | Telecom session bridge for USSD menus | Session request and response | Write (session replies), and read patterns per spec | Service operator policy |
This page does not define authentication headers or endpoint literals. Those are on the Authentication matrix and Networks and endpoints. For SDK and product names, see the Product and SDK map.