REST API

Browser Sessions

List and inspect your cloud browsers.

Browsers start automatically when a task needs one and close when it ends, unless keep_browser was set. Use POST /navigations to open an approved page.

GET/browser-sessions

List your live cloud browser sessions (up to 20, newest first).

Auth: Bearer API key · Permission: sessions:read

all

query · boolean

true to include ended sessions.

curl https://taken.trade/api/public/v1/browser-sessions \
  -H "Authorization: Bearer $TAKEN_API_KEY"

Errors: 401 missing_api_key / invalid_api_key / api_key_revoked / api_key_expired · 403 insufficient_scope · 429 rate_limited

GET/browser-sessions/{id}

Get one of your sessions by id.

Auth: Bearer API key · Permission: sessions:read

path · uuid · required

Session id.

curl https://taken.trade/api/public/v1/browser-sessions/ID \
  -H "Authorization: Bearer $TAKEN_API_KEY"

Errors: 400 invalid_request · 404 not_found

POST/navigations

Open an approved website. Creates a task (same rules as the app) that starts or reuses your browser; poll the task for the result.

Auth: Bearer API key · Permission: browser:write

url	body · string · required	https URL on Taken's approved site list.
window	body · integer 1–3	Browser window (your plan decides how many).

curl -X POST https://taken.trade/api/public/v1/navigations \
  -H "Authorization: Bearer $TAKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Errors: 422 url_not_allowed · 422 task_rejected (subscription, limits, busy window)

POST/agent/tasks

Submit a natural-language browser task. Trading, payments and credentials in instructions are refused.

Auth: Bearer API key · Permission: tasks:write

instruction	body · string ≤1000 · required	What Taken should do.
window	body · integer 1–3	Default 1.
keep_browser	body · boolean	Keep the browser open after the task (up to the browser time limit).

curl -X POST https://taken.trade/api/public/v1/agent/tasks \
  -H "Authorization: Bearer $TAKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"Open example.com and tell me the page title"}'

Errors: 400 invalid_request · 422 task_rejected

GET/agent/tasks/{id}

Get a task's real status, result and recent events. While the task is running, each call first advances it by one bounded step (up to ~45 s). Poll until done is true.

Auth: Bearer API key · Permission: tasks:read

id	path · uuid · required	Task id.
advance	query · boolean	false to read without advancing.

curl https://taken.trade/api/public/v1/agent/tasks/ID \
  -H "Authorization: Bearer $TAKEN_API_KEY"

Errors: 404 not_found

POST/agent/tasks/{id}/cancel

Cancel one of your tasks and close its browser.

Auth: Bearer API key · Permission: tasks:write

path · uuid · required

Task id.

curl -X POST https://taken.trade/api/public/v1/agent/tasks/ID/cancel \
  -H "Authorization: Bearer $TAKEN_API_KEY"

Errors: 404 not_found

GET/connected-platforms

List supported platforms and your connection status. order_automation is false for every platform today.

Auth: Bearer API key · Permission: platforms:read

curl https://taken.trade/api/public/v1/connected-platforms \
  -H "Authorization: Bearer $TAKEN_API_KEY"

POST/trading/order-previews

Parse an order description into a structured draft and list missing details. Nothing is saved or submitted; approval only happens in the Taken app.

Auth: Bearer API key · Permission: orders:prepare

instruction

body · string ≤500 · required

e.g. “buy 1 NQ limit 18000 on Tradovate”.

curl -X POST https://taken.trade/api/public/v1/trading/order-previews \
  -H "Authorization: Bearer $TAKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"buy 1 NQ"}'

Errors: 400 invalid_request