Skip to main content

​
Base URLs

Symphony API is available in two environments:
  • Development: Contact the Symphony team for the testing environment details
  • Production: https://api.symphony.io/

​
Authentication

Symphony support three types of authentication:
  • JWT Token for Business Integrations
  • Privy Authentication
  • Symphony API Keys

​
Symphony API Key

Trading endpoints (like batch trading operations) use Symphony API Key authentication. Include your API key in the request headers as shown below. Generate your API key here. 
x-api-key: YOUR_API_KEY
Example using cURL: 
curl -X POST 'https://api.symphony.io/agent/batch-open' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{...}'

​
Privy Auth

Most endpoints use Privy authentication. You’ll need to provide:
  • privyIdToken: Privy ID token (sent as header x-privy-id-token)
  • privyAuthToken: Privy authentication token (sent as Bearer token)
Include these tokens in the request headers: 
x-privy-id-token: YOUR_PRIVY_ID_TOKEN
Authorization: Bearer YOUR_PRIVY_AUTH_TOKEN
Example using cURL: 
curl -X POST 'https://api.symphony.io/endpoint' \
  -H 'x-privy-id-token: YOUR_PRIVY_ID_TOKEN' \
  -H 'Authorization: Bearer YOUR_PRIVY_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{...}'
Check each endpoint’s documentation for the specific authentication method required.