# API authentication

> How authentication works across the IXO Protocol gateways and IXO service APIs, who sets the rules for each API family, and a security baseline for every call.

This page explains authentication by API family across the IXO Protocol and IXO service APIs. Use
it to understand who decides what credentials an API takes before you integrate with it. For the
literals (headers, token sources and behaviour per environment), use the
[Authentication matrix](/reference/authentication-matrix).

## Scope

- This page summarizes authentication methods by API family.
- It does not define one flow for all IXO APIs.
- Protocol APIs and service APIs can require different credentials.

## Request patterns

The header formats used across the IXO docs are collected in the
[Authentication matrix](/reference/authentication-matrix).

<Warning>
Do not assume any one header or token type applies to every endpoint. Confirm each interface
against the [Authentication matrix](/reference/authentication-matrix).
</Warning>

## API families and who sets the rules

| Family | APIs | Authentication |
| --- | --- | --- |
| Protocol gateways | [Blockchain RPC API](/api-reference/rpc-api), [Blockchain REST API](/api-reference/grpc-gateway-api) | Chain and node access patterns vary by network and deployment. |
| Service APIs | [IXO Blocksync GraphQL API](/api-reference/blocksync-graphql-api), [Matrix state bot API](/api-reference/matrix-state-bot-api), [Registry API](/api-reference/registry-api) | Service operators can enforce different credentials and scopes. |

## Security baseline

- Use HTTPS for all authenticated requests.
- Keep credentials in secure runtime storage, not source files.
- Rotate tokens and keys according to your operator policy.
- Log request identifiers and authentication failures for incident triage.

## Related

<CardGroup cols={3}>
  <Card title="Authentication matrix" icon="table" href="/https/docs.ixo.world/reference/authentication-matrix">
    The credential each interface takes, with the header formats.
  </Card>
  <Card title="Networks and endpoints" icon="network-wired" href="/https/docs.ixo.world/reference/networks-and-endpoints">
    Endpoint mappings for each network.
  </Card>
  <Card title="Product and SDK map" icon="diagram-project" href="/https/docs.ixo.world/reference/product-and-sdk-map">
    IXO products, APIs and SDKs, with their routes.
  </Card>
</CardGroup>
