Authentication
All API requests require authentication using an API key. Keys are scoped to your account and can be managed in the dashboard.
API Key Header
Include your API key in the Authorization header as a Bearer token:
Authorization: Bearer ftx_sk_live_...
Example Request
curl https://api.finaltx.com/v1/agents \ -H "Authorization: Bearer ftx_sk_live_abc123..." \ -H "Content-Type: application/json"
Key Types
ftx_sk_live_...ProductionLive API keys for production use. Transactions create real contracts and move real money.
ftx_sk_test_...TestTest API keys for development. Transactions are simulated and no real money moves.
Creating API Keys
Create and manage API keys in the dashboard:
- 1.Go to Dashboard → API Keys
- 2.Click "Create New Key"
- 3.Give it a descriptive label (e.g., "production-server")
- 4.Copy and store the key securely — it won't be shown again
Security Best Practices
!Never expose API keys in client-side code or public repositories
!Use environment variables to store keys
!Rotate keys periodically and after any suspected compromise
!Use separate keys for development and production
!Monitor API key usage in the dashboard
Authentication Errors
401Unauthorized
{ "error": "Invalid or missing API key" }403Forbidden
{ "error": "API key does not have access to this resource" }