Base URL
All API requests are made to:
https://api.deepcurrent.app/api/v1
Endpoint groups
| Group | Base path | Description |
|---|
| Intelligence | /intelligence | Curated Web3 intelligence — resolve, quote, execute, and expand results |
| Growth | /growth | Goal-driven growth runs — resolve goal plan, quote cost, launch, and poll status |
| BD Jobs | /bd | Direct BD enrichment jobs with full pipeline presets |
| Account | /users, /credits, /subscriptions | Profile, credit usage analytics, and subscription management |
| Chats | /chats | Conversation threads that group tool calls and results |
| Results | /results | Tool execution results stored for download and replay |
Authentication
All endpoints require a Bearer token in the Authorization header. See the authentication guide for how to obtain a token.
Rate limiting
There is no hard HTTP rate limit on REST endpoints. Credit balance acts as the primary consumption gate for Intelligence, Growth, and BD tool calls — each call deducts credits according to a quote agreed before execution. Requests that exceed your credit balance are rejected with 402 Payment Required.
Always call the relevant /quote endpoint first. Quote tokens are single-use and expire after a short window.
Error codes
| Status | Meaning |
|---|
400 Bad Request | Malformed request body or invalid field values |
401 Unauthorized | Missing or expired authentication token |
403 Forbidden | Authenticated but not permitted (e.g. inactive subscription, wrong quote token) |
404 Not Found | Resource does not exist or does not belong to your account |
422 Unprocessable Entity | Request body failed schema validation |
429 Too Many Requests | (Reserved) request-level throttle, not currently enforced |
{
"detail": "Human-readable description of the error"
}