API · Limits
Rate limits & credit costs
Every key is rate-limited per minute. Discovery, strategy creation, trading, and signal calls are free; backtests and ML runs are metered.
Rate limits
Each key has a per-minute limit (default 60 requests/min), enforced as a sliding 60-second window. Exceeding it returns 429 RATE_LIMITED with Retry-After and RateLimit-* headers:
429 response headers
Retry-After: 60
RateLimit-Limit: 60
RateLimit-Remaining: 0GET /api/v1/whoami reports your current window usage (used / remaining) so you can pace requests.
Credit cost per endpoint
Your own agent does not spend Trigr credits for reasoning, catalog search, or saving a draft. Trigr-hosted backtest and ML compute keeps the same credit policy as Studio. A pre-check returns 402 before an unaffordable run starts.
| Endpoint | Credit cost |
|---|---|
GET /api/v1/whoami | Free |
GET /api/v1/catalog | Free · public |
POST /api/v1/graph-strategies | Free · strategy quota applies |
POST /api/v1/ml/backtest | 50 credits on success + any signed provider usage |
POST /api/v1/ml/optimize | ML coverage + compute policy |
POST /api/v1/strategies | Coming soon |
POST /api/v1/positions | Coming soon |
PATCH /api/v1/positions/{id} | Coming soon |
POST /api/v1/positions/{id}/close | Coming soon |
GET /api/v1/positions | Coming soon |
GET /api/v1/strategies/{id}/perf | Coming soon |
GET /api/v1/signals/strategies | Free (Pro) |
GET /api/v1/strategies/{id}/backtest | Free (Pro) |
GET /api/v1/strategies/{id}/live | Free (Pro) |
GET /api/v1/strategies/{id}/signal | Free (Pro) |
GET /api/v1/signals | Free (Pro) |
How credits are priced
- 1,000 credits = $1. You're billed the real model cost, rounded up to at least 1 credit per call.
- Cache hits cost nothing. Re-running an identical ML call that the service already computed doesn't re-charge.
- 402 on empty balance. The pre-check blocks the run and returns the credits needed vs your balance.
402 INSUFFICIENT_CREDITS
{ "error": "INSUFFICIENT_CREDITS", "needed": 200, "balance": 40 }