dogabot docs

Auth and scopes

Send the key on every request:

Authorization: Bearer dbk_live_...

Do not use a Clerk JWT. Keys are created under MCP & API in the app and shown once.

Read scopes

ScopeAccess
read:accountCurrent user, statistics, positions, position legs, and your emitters
read:automationsFollowers, bots, emitters, portfolios, and summaries
read:ordersAutomation orders and terminal orders, positions, and exchange balances
read:signalsEmitter signals
read:backtestsBacktest jobs, signals, and quota
read:marketsTickers, markets, exchanges, marketplace search, candles, order book, trades, funding

Write scopes

ScopeAccessExtra gate
write:lifecycle Start/stop followers, bots, emitters, and portfolios feat:api:write (institutional)
write:automation Create a follower; patch owned automations feat:api:write (institutional)
write:backtest Create or cancel a backtest (REST and MCP) feat:api:write (institutional)
write:terminal Place or cancel a terminal order (REST and MCP) feat:terminal (Pro or Institutional)

Pro keys default to all read:* scopes. Write scopes are opt-in at key creation when your plan allows them.

Writes

Send Idempotency-Key on every mutating request so retries stay safe. Automation start/stop is REST-only; MCP cannot start or stop automations.