Developer docs
Limits and pricing
Oimo is free during the beta. We will announce pricing before it applies to you.
Limits
| What | Limit |
|---|---|
| API keys per workspace | 20 |
| Webhooks per workspace | 20 |
| Workspaces | You can create a workspace while you belong to fewer than 3 (workspaces you were invited to count) |
| Invitations per workspace | 20 in any 24 hours |
| Name of a webhook, API key or workspace | 80 characters |
| Alias groups per webhook | 50 |
| Entries per resource or document filter (per provider) | 200, each up to 200 characters |
| Price history page | 1 to 10,000 rows, default 5,000 |
asOf | At least 15 minutes in the past |
| Webhook response time | 5 seconds |
| Webhook paused after | 5 failed attempts in a row over at least 24 hours |
| Delivery attempts | 6 (retries after 5 minutes, 30 minutes, 2 hours, 8 hours and 24 hours) |
| Delivery log | Newest 50 deliveries per webhook, each kept 30 days after its last attempt |
Rate limits
Requests are limited with token buckets: each allows a steady rate and a short burst above it. A request must fit in every bucket that applies.
| Bucket | Rate | Burst |
|---|---|---|
| Per API key, and per signed-in user | 5 requests a second | 20 |
| Per workspace: all its keys and users together | 10 requests a second | 40 |
GET /v1/prices/history, per key or user, on top of the above | 2 requests a second | 5 |
| Per client address: requests that fail authentication, and sign-in | 5 requests a second | 20 |
A request over a limit is answered with 429, error code rate_limited and a retry-after header with the number of seconds to wait. Wait at least that long before retrying, and add jitter when several workers share a key. To read a lot of history, ask for large pages (limit up to 10,000) rather than many small ones.
HTTP/1.1 429 Too Many Requests
retry-after: 1
content-type: application/json
{"error":{"code":"rate_limited","message":"Too many requests; retry in 1 s"}}