API key authentication
Send your developer API key on every authenticated request using either header:Common scopes
Required REST HMAC signing
Every API-key authenticated request must be signed with the API secret returned when the key was created. JWT and OAuth bearer session tokens are exempt.String to sign
METHOD- uppercase HTTP verb (GET,POST, …)path- full request path including query string (e.g./api/v1/developers/earnings)body- raw JSON string for POST/PUT/PATCH, or empty string when there is no body
curl example (GET)
curl example (POST)
Python (echozero-sdk)
hmac=True is the default for API-key clients — every request is signed automatically.
TypeScript (echozero-sdk)
hmacSecretKey is configured.
Or sign manually with signRestRequest:
HMAC error responses
MCP authentication
API keys (with required HMAC) work onPOST https://mcp.echozero.app/mcp the same way as REST. Send x-api-key or Authorization: Bearer on every MCP call, including initialize. See the MCP Server guide.