Auto-Sync
Inspect broker auto-sync connections, read sync history, and trigger a manual sync.
GET /autosync/connections
Scope: read:autosync
List your auto-sync connections. No token material is ever exposed.
GET /autosync/connections/{id}
Scope: read:autosync
Single connection.
GET /autosync/log
Scope: read:autosync
Sync history.
POST /autosync/connections/{id}/sync
Scope: write:autosync · Plan gate: Pro
Trigger an immediate sync on a broker connection. Routes through the same dupe-detection + import pipeline the settings UI uses, so a manual sync from the API is byte-identical to one triggered from the dashboard.
No request body. The connection’s configured Tradavity account_id is the import target.
| Status | Code | Meaning |
|---|---|---|
| 200 | (no error code) | Sync ran. Body data contains connection_id, log_id, imported, skipped, total_fetched, total_trades, total_pnl, errors[], and a human-readable message. |
| 400 | validation_error | Connection inactive or no broker account selected. |
| 401 | token_expired | Broker token expired or could not be refreshed. The user needs to reconnect via the settings UI. |
| 404 | not_found | No connection with that id, or it doesn’t belong to you. |
| 429 | limit_reached | Pro plan required for sync. |
| 429 | connection_sync_cooldown | Per-connection cooldown — manual syncs are capped to once every 20 seconds per connection to protect the upstream broker API from amplification. Distinct from the key-level rate limit. Headers: X-RateLimit-Scope: connection-sync, Retry-After: <seconds>. error.details.retry_after_seconds mirrors the header. Cron-triggered syncs (the 15-minute auto-sync schedule) bypass this gate. |
| 502 | broker_api_error | Upstream broker API returned an error. Retry later. |
| 500 | sync_failed | Sync pipeline raised an unexpected error (parser crash, DB transaction abort, etc.). Retrying is safe — the operation is idempotent on the broker side. |
# Replace 12 with one of your connection_ids from GET /autosync/connections
curl -X POST "https://app.tradavity.com/api/v1/autosync/connections/12/sync" \
-H "Authorization: Bearer tvty_YOUR_KEY_HERE" \
-H "Idempotency-Key: $(uuidgen)"The Idempotency-Key cache returns the same imported/skipped numbers on replay without hitting the broker again. Useful when a flaky network kills the response but the sync already ran.