Choose an IXO API

Compare the IXO Protocol gateways with the IXO service APIs by purpose, typical operations, read and write access, and where authentication is defined.

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

KindWhat it is
Protocol gatewaysNode-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 APIsOperator-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

APIPrimary purposeTypical operationsRead or writeAuthentication and endpoints
Blockchain RPC APITransactions, ABCI queries, Tendermint RPCbroadcast_tx_*, status, block, tx searchRead and write (tx)Authentication matrix and Networks and endpoints
Blockchain REST API (gRPC gateway)HTTP and JSON queries, and tx broadcast where exposedModule REST paths, Swagger or OpenAPI per deploymentRead. Write depends on deploymentSame as RPC. Confirm with the node operator
IXO Blocksync GraphQL APIIndexed queries over chain-derived entitiesGraphQL queries (subscriptions if enabled)Read-only in the docs modelService operator credentials
Matrix state bot APIRoom state, ACLs and automation hooks for MatrixBot-specific HTTP endpointsRead and write (room operations)Service operator credentials
Registry APIImpact Hub Registry application workflowsCRUD-style registry operations per specRead and write (per spec)Often Basic or bearer. Confirm in the Authentication matrix
USSD gateway APITelecom session bridge for USSD menusSession request and responseWrite (session replies), and read patterns per specService 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.

Next steps