ApiClient authentication and authorization signatures
Authenticate CoinVoyage ApiClient calls and generate HMAC-SHA256 signatures for privileged v3 API operations.
ApiClient sends your API key with every request. Privileged organization operations additionally require an HMAC-SHA256 signature generated from your API secret.
Generate authorization signatures only on your server. A leaked API secret can create sales, refunds, invoices, off-ramp intents, webhooks, and fee claims for your organization.
Signed server-side operations include SALE orders, refunds, organization-wide listing, off-ramp management, invoices, fees, webhooks, and organization-wide WebSocket subscriptions.
generateAuthorizationSignature() creates the HMAC-SHA256 Authorization header value used by signed v3 requests. Pass the v3 path without the /v3 prefix.
Sign the exact method and path used by the request. Examples include /orders, /orders/{order_id}/refund, /invoices, /invoices/{invoice_id}/archive, and /ws.
ApiClient methods that accept apiSecret generate and attach the appropriate signature automatically. Call generateAuthorizationSignature() directly only when building a raw request or an organization-wide WebSocket connection.