Create a portfolio · dogabot docs

post https://api.dogabot.com/api/v1/portfolios

Creates a portfolio for the key owner. Requires the listed write scope and feat:api:write on an Institutional account. Send Idempotency-Key.

Scopes write:automation write

Headers

Idempotency-Key string required

Unique key per mutation so retries stay safe.

Example retry-1

Body parameters

application/json required

name string required

initial_capital number

≥ 0

max_members integer

≥ 1

trading_mode string

REST defaults to paper when omitted (unlike bots, which default to live).

One of livepaper

members array of object

Optional emitter members to attach on create. member_type must be emitter (or empty).

member_type string

Must be emitter (or omit). Portfolios cannot be nested.

One of emitter

member_id integer

weight number

tags array of string

Existing catalog lookup_keys (max 5).

Responses

201 Created

401 Unauthorized

403 Forbidden — missing scope or feature gate

404 Not found

429 Rate limited

curl -X POST 'https://api.dogabot.com/api/v1/portfolios' \ -H "Authorization: Bearer $DOGABOT_API_KEY" \ -H 'Idempotency-Key: retry-1' \ -H 'Content-Type: application/json' \ -d '{"name":"Paper desk","trading_mode":"paper","initial_capital":2000,"max_members":10,"members":[{"member_type":"emitter","member_id":1001,"weight":1},{"member_type":"emitter","member_id":1002,"weight":1}]}'

import os import requests resp = requests.request( "POST", "https://api.dogabot.com/api/v1/portfolios", headers={"Authorization": f"Bearer {os.environ['DOGABOT_API_KEY']}", "Idempotency-Key": "retry-1"}, json={ "name": "Paper desk", "trading_mode": "paper", "initial_capital": 2000, "max_members": 10, "members": [ { "member_type": "emitter", "member_id": 1001, "weight": 1, }, { "member_type": "emitter", "member_id": 1002, "weight": 1, }, ], }, timeout=30, ) resp.raise_for_status() print(resp.json())

package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { body := strings.NewReader(`{"name":"Paper desk","trading_mode":"paper","initial_capital":2000,"max_members":10,"members":[{"member_type":"emitter","member_id":1001,"weight":1},{"member_type":"emitter","member_id":1002,"weight":1}]}`) req, _ := http.NewRequest("POST", "https://api.dogabot.com/api/v1/portfolios", 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)) }