API Documentation
Read-only, programmatic access to your own Tradeivant trade data. This API is included with the Elite plan -- generate a key from Settings → API Access.
Authentication
Every request must include your API key as a Bearer token. Keys are shown once at generation time -- store them securely. A revoked or invalid key returns 401; a key belonging to an account no longer on Elite returns 403.
Authorization: Bearer tdvt_pub_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxRate limits
60 requests per minute per key. Exceeding this returns 429 with a Retry-After header.
Endpoints
Your plan tier and total trade count.
curl https://tradeivant.com/api/v1/account \
-H "Authorization: Bearer tdvt_pub_..."
{
"userId": "...",
"tier": "elite",
"tradeCount": 214
}Your own trades, most recent first. Supports limit (default 50, max 200) and offset query params.
curl "https://tradeivant.com/api/v1/trades?limit=50&offset=0" \
-H "Authorization: Bearer tdvt_pub_..."
{
"trades": [
{
"id": "...",
"pair": "EURUSD",
"direction": "buy",
"entry_price": 1.1,
"exit_price": 1.12,
"lot_size": 1,
"trade_date": "2026-08-01",
"result": "win",
"strategy": "Breakout",
"created_at": "2026-08-01T12:00:00Z"
}
],
"pagination": { "limit": 50, "offset": 0, "total": 214 }
}What's not here yet
This is a v1, read-only surface -- there is currently no endpoint to create or modify trades via the API. More endpoints are planned; this page will be updated as they ship.