Rate limits

Rate limits are counted in fixed one-minute windows, except where a row says otherwise. A window is shared by every process. Every answer after the rate-limit check carries the headers below. A 429 also sends Retry-After, a whole number of seconds, at least 1.

A request still counts against the rate limit when it does not count as a monthly call. An empty events page is the usual case. A missing or unknown key is not rate limited.

Limits

• Bucket: One key. Limit: The plan's calls a minute: Free 10, Trader 60, Pro 300. `reason` on 429: key
• Bucket: One account, keys together. Limit: Twice that number. `reason` on 429: account
• Bucket: Open event long-polls for one key. Limit: 2 at once. `reason` on 429: long_polls
• Bucket: Open event long-polls on one process. Limit: 200 at once. `reason` on 429: server_busy
• Bucket: Rule create, change, pause, resume, and delete. Limit: 60 a minute for the account. The app uses the same bucket.. `reason` on 429: account
• Bucket: Previews. Limit: 120 a minute for the account, and 20 a minute for watchlist previews. Retry-After is 5.. `reason` on 429: previews
• Bucket: Webhook test sends. Limit: 10 a minute for the account. `reason` on 429: tests
• Bucket: Key creation. Limit: 10 a day for the account. This is the Settings screen, not a /v1 route.

Headers

• Header: RateLimit-Limit. Value: The key's per-minute limit
• Header: RateLimit-Remaining. Value: Calls left in the current window for the key. Never below 0.
• Header: RateLimit-Reset. Value: Whole seconds until that window resets
• Header: Terminal-Quota-Remaining. Value: Included calls left this month. 0 means further calls use blocks.
• Header: Retry-After. Value: On 429 only. Whole seconds, at least 1.

GET /v1/assets is a normal read. query returns up to 5 matches. A symbol of 3 characters matches that symbol.

Example. These are not live prices.

GET /v1/assets?query=SOL HTTP/1.1
Authorization: Bearer $TERMINAL_API_KEY

HTTP/1.1 200 OK

{
  "assets": [
    { "symbol": "SOL", "name": "Solana", "status": "active" }
  ]
}

Create a free account

Terminal reports market events for conditions you set. It does not tell you to buy, sell, or hold, and it does not place trades.