Skip to main content
Grat uses API keys to authenticate requests and track usage. Authenticated requests ensure that your transactions are sponsored from the correct project balance and are subject to your specific policy rules.

​
API Key Header

Include your API key in every request using the X-API-Key header. 
curl -X POST https://relay.yourdomain.com/v1/sponsor \
  -H "X-API-Key: sr_live_..." \
  -H "Content-Type: application/json"

​
Key Prefixes

Grat uses prefixes to distinguish between environments:
  • sr_test_: Used for testnet integrations. No credits are required.
  • sr_live_: Used for mainnet production integrations. Requires a credit balance.
During the current development phase (Phase 1), the testnet relay is open and does not require an API key or authentication header.

​
Administrative Access

Some endpoints, such as channel management and project configuration, require an ADMIN_TOKEN. This token should be kept strictly confidential and only used from secure server-side environments. View on GitHub