Set a bot book leg · dogabot docs

post https://api.dogabot.com/api/v1/bots/{id}/books

Sets one bot book leg (signed position). Default book-only; optional place_on_venue. Session or MCP OAuth only — API keys are rejected. Requires the listed write scope and feat:api:write on an Institutional account. Send Idempotency-Key.

Scopes write:lifecycle write

Path parameters

id integer required

Example 42

Headers

Idempotency-Key string required

Unique key per mutation so retries stay safe.

Example retry-1

Body parameters

application/json

JSON Example body

{
  "exchange": "aster_dex",
  "symbol": "ETHUSDT",
  "position": 0,
  "reason": "accounting_correction",
  "place_on_venue": false
}

Responses

200 OK

401 Unauthorized

403 Forbidden — missing scope or feature gate

404 Not found

429 Rate limited

curl -X POST 'https://api.dogabot.com/api/v1/bots/42/books' \ -H "Authorization: Bearer $DOGABOT_API_KEY" \ -H 'Idempotency-Key: retry-1' \ -H 'Content-Type: application/json' \ -d '{"exchange":"aster_dex","symbol":"ETHUSDT","position":0,"reason":"accounting_correction","place_on_venue":false}'

import os import requests resp = requests.request( "POST", "https://api.dogabot.com/api/v1/bots/42/books", headers={"Authorization": f"Bearer {os.environ['DOGABOT_API_KEY']}", "Idempotency-Key": "retry-1"}, json={ "exchange": "aster_dex", "symbol": "ETHUSDT", "position": 0, "reason": "accounting_correction", "place_on_venue": False, }, timeout=30, ) resp.raise_for_status() print(resp.json())

package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { body := strings.NewReader(`{"exchange":"aster_dex","symbol":"ETHUSDT","position":0,"reason":"accounting_correction","place_on_venue":false}`) req, _ := http.NewRequest("POST", "https://api.dogabot.com/api/v1/bots/42/books", body) req.Header.Set("Authorization", "Bearer "+os.Getenv("DOGABOT_API_KEY")) req.Header.Set("Idempotency-Key", "retry-1") req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) }

{ "book_updated": true, "bot_id": 259, "exchange": "aster_dex", "symbol": "ETHUSDT", "previous_position": 0.003, "position": 0, "avg_entry_price": 0, "reason": "accounting_correction", "parks_canceled": [ { "order_id": "18294257325", "client_order_id": "dogabot-ti…", "role": "increase_limit" } ], "parks_failed": [], "resync_queued": false }