Error Handling

Handle errors gracefully when using Synth API.

HTTP Status Codes

Code	Meaning	Action
200	Success	Process response
400	Bad Request	Check parameters
401	Unauthorized	Check API key
404	Not Found	No data available
429	Rate Limited	Retry after delay
500	Server Error	Retry later

Error Response Format

{
  "error": "Error Type",
  "message": "Detailed error message",
  "code": "ERROR_CODE"
}

Common Errors

Invalid API Key

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Solution: Verify your API key in the dashboard.

Invalid Parameters

{
  "error": "Bad Request",
  "message": "Invalid asset symbol"
}

Solution: Check supported assets.

No Data Available

{
  "error": "Not Found",
  "message": "No predictions available"
}

Solution: Try different parameters or wait for new data.

Best Practices

example.py

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    data = response.json()
    
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 400:
        print("Check your parameters")
    elif e.response.status_code == 401:
        print("Check your API key")
    elif e.response.status_code == 404:
        print("No data available")
    elif e.response.status_code == 429:
        print("Rate limited - waiting...")
        time.sleep(60)