Public Signal APIs
Signal endpoints are public. No API key is required for basic access to:
GET /v1/signals/latestGET /v1/signals/market/{market_id}GET /v1/signals/{signal_id}GET /v1/signals/{signal_id}/entitiesGET /v1/signals/statsGET /v1/signals/reportPOST /v1/signals/smart-moneyGET /v1/health
Tiers & Rate Limits
| Tier | Requests / min | Intended Use |
|---|---|---|
free | 120 | Evaluation and testing |
pro | 600 | Production traders |
agent | 3,000 | AI agents and automated systems |
Public requests are rate-limited per client by default. Bearer API keys may be used for higher limits when issued for your account.
Error Codes
| Code | Meaning |
|---|---|
400 | Invalid request payload or parameters |
401 | Missing or invalid API key when required |
403 | Request is not allowed for the current key |
404 | Requested resource not found |
422 | Invalid typed request body or query params |
429 | Rate limit exceeded |
500 | Internal server error |
503 | Service temporarily unavailable |
All error responses follow this shape:
{
"detail": "description of the error"
}For on-demand signal endpoints, a missing market or a request that produces no qualifying signal usually returns 200 with an empty data array rather than 404.
Base URL
https://api.agentsona.com/v1