Place a terminal order (async ack)

post https://api.dogabot.com/api/v1/terminal/place-order

Places a terminal order and returns an async ack. Poll by client_order_id for fills. Prefer paper. Requires write:terminal on the key and feat:terminal on the account. Send Idempotency-Key.

Scopes write:terminal write

Headers

Idempotency-Key string required

Unique key per mutation so retries stay safe.

Example place-paper-btc-1

Body parameters

application/json required

exchange string required

symbol string required

side string required

One of buysell

quantity number required

price number

Required for limit; 0 for market.

order_type string

One of marketlimit

trading_mode string

One of livepaper

broadcast_mode string

One of personalleader

emitter_id integer

Required when broadcast_mode is leader.

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/terminal/place-order' \ -H "Authorization: Bearer $DOGABOT_API_KEY" \ -H 'Idempotency-Key: place-paper-btc-1' \ -H 'Content-Type: application/json' \ -d '{"exchange":"hyperliquid","symbol":"BTC","side":"buy","quantity":0.001,"price":0,"order_type":"market","trading_mode":"paper","broadcast_mode":"personal"}'

import os import requests resp = requests.request( "POST", "https://api.dogabot.com/api/v1/terminal/place-order", headers={"Authorization": f"Bearer {os.environ['DOGABOT_API_KEY']}", "Idempotency-Key": "place-paper-btc-1"}, json={ "exchange": "hyperliquid", "symbol": "BTC", "side": "buy", "quantity": 0.001, "price": 0, "order_type": "market", "trading_mode": "paper", "broadcast_mode": "personal", }, timeout=30, ) resp.raise_for_status() print(resp.json())

package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { body := strings.NewReader(`{"exchange":"hyperliquid","symbol":"BTC","side":"buy","quantity":0.001,"price":0,"order_type":"market","trading_mode":"paper","broadcast_mode":"personal"}`) req, _ := http.NewRequest("POST", "https://api.dogabot.com/api/v1/terminal/place-order", body) req.Header.Set("Authorization", "Bearer "+os.Getenv("DOGABOT_API_KEY")) req.Header.Set("Idempotency-Key", "place-paper-btc-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)) }

{ "status": "accepted", "broadcast_mode": "personal", "session_id": 9, "client_order_id": "dogabot-t1a2b3c4", "side": "buy", "quantity": 0.001, "symbol": "BTC", "exchange": "hyperliquid", "trading_mode": "paper" }