API Authentication

Use the Anthid API reference to explore available endpoints, request parameters, response schemas, and errors.

Authentication

Anthid endpoints use one or more of the following credential types:

Credential	Header	Typical use
Organization API key	`x-api-key: <YOUR_API_KEY>`	Intent submission, ledger queries, controls, connections, and streaming
User bearer token	`Authorization: Bearer <YOUR_ACCESS_TOKEN>`	User, organization, account, and administrator workflows
Client-credentials bearer token	`Authorization: Bearer <YOUR_SERVICE_TOKEN>`	Service-to-service reads and restricted credential operations

Not every endpoint accepts every credential type. The authentication section on each generated endpoint page is authoritative. Keep credentials private. Do not embed API keys, user tokens, or service tokens in public client-side code.

REST

REST requests use JSON for both request bodies and responses. Include Content-Type: application/json when sending a request body. Organization API key example:

curl https://api.anthid.com/v1/intents \
  -X POST \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "trading_account_id": "<ACCOUNT_ID>",
    "command": {
      "type": "CREATE",
      "payload": {
        "symbol": "AAPL",
        "order_side": "BUY",
        "spec": {
          "Market": {
            "quantity": "1"
          }
        }
      }
    }
  }'

User bearer token example:

curl "https://api.anthid.com/v1/accounts?enabled=true" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

Service-account reads that cross organization boundaries may also require:

x-organization-id: <ORGANIZATION_ID>

gRPC

The Streaming API uses an organization API key in gRPC metadata. Clone the public protobuf repository so grpcurl can load the current split service definition.

git clone https://github.com/anthid-labs/proto.git anthid-proto

grpcurl \
  -import-path ./anthid-proto \
  -proto trading/trading_service.proto \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{
    "trading_account_id": "YOUR_TRADING_ACCOUNT_ID",
    "subscriptions": ["EVENT_TYPE_BROKER_ORDER"]
  }' \
  stream.anthid.com:443 \
  trading.TradingService/SubscribeEvents

Support

For questions about authentication, request formats, or API behavior, contact support.

Connections

Organizations

Controls

Accounts

Intents

Ledger

Stream

MCP

API Authentication

Authentication

REST

gRPC

Support

​Authentication

​REST

​gRPC

​Support

Authentication

REST

gRPC

Support