Public API · v1
Tradavity API Reference
Build integrations, custom dashboards, AI agents, and automation against your trading journal. REST-style, JSON, Bearer-token auth, per-user scoped. Base URL: https://app.tradavity.com/api/v1
Core Concepts
Authentication
How to authenticate Tradavity Public API requests with a Bearer token or X-API-Key header.
Scopes
Scope catalog for the Tradavity Public API, with verb:resource semantics and the full read/write pairing.
Rate Limits
Tradavity Public API rate limits: per-key, per-user, per-day, with X-RateLimit headers and Retry-After semantics.
Idempotency
How the Tradavity Public API Idempotency-Key header guarantees retry-safe writes.
Conventions
Response envelope, datetime format, IDs, pagination, body size caps, and write-endpoint conventions for the Tradavity Public API.
Error Codes
Every Tradavity Public API error code, mapped to its HTTP status and meaning.
Resources
Trades
List, read, create, edit, archive trades; manage screenshots, tags, and confirmations on a trade.
Strategies
Strategies and setups: list, read, create, update with embedded setups upsert, and delete.
Tags
Tags and tag categories: list, create, update, delete. Per-trade tag assignment lives on the Trades page.
Goals
Goals and period progress snapshots: list, read, create, update, delete.
Protocols
Protocols (pre-trade checklists, EOD reviews, etc.) and their recorded responses. Full CRUD on both.
Accounts
Trading accounts: list, read, create, edit, archive. Includes balance events, payouts, and snapshots.
Copy Groups
Copy trading groups: list, read, create, update, delete; replace the member set.
Auto-Sync
Auto-sync connection status, sync history, and manual sync trigger for broker integrations.