Build on Backed

https://api.backed.io

{ "error": { "code": "insufficient_scope", "message": "this API key is read-only (needs the trade scope)" } }

import os, time, uuid, requests

API = "https://api.backed.io"
H = {"Authorization": f"Bearer {os.environ['BACKED_API_KEY']}"}

# 1. a tradable account, and how much room it has
me = requests.get(f"{API}/v1/me", headers=H).json()
acct = next(a for a in me["accounts"] if a["tradable"])
view = requests.get(f"{API}/v1/accounts/{acct['id']}", headers=H).json()
print(acct["planLabel"], view["balanceUsdc"], view["equity"], "left before max drawdown:", view["leftUsd"])

# 2. find the BTC perp
perps = requests.get(f"{API}/v1/instruments", params={"market": "perps"}).json()["items"]
btc = next(i for i in perps if i["externalId"] == "BTC")

# 3. a $500, 5x long with a stop-loss (the Idempotency-Key makes a retry safe)
order = requests.post(f"{API}/v1/orders", headers={**H, "Idempotency-Key": str(uuid.uuid4())}, json={
    "accountId": acct["id"], "instrumentId": btc["id"], "side": "buy", "type": "market",
    "notional": "500", "leverage": 5,
    "tpsl": [{"kind": "sl", "triggerPrice": str(round(float(btc["mark"]) * 0.98, 1)), "sizePct": 100}],
}).json()

# 4. orders are filled or rejected within seconds: poll for the result
for _ in range(10):
    o = requests.get(f"{API}/v1/orders/{order['orderId']}", headers=H).json()
    if o["status"] in ("filled", "rejected", "cancelled"):
        print(o["status"], o.get("reject_rule"))
        break
    time.sleep(1)

You are trading a Backed prop-firm account through its REST API.
Base URL: https://api.backed.io   Auth header: Authorization: Bearer $BACKED_API_KEY

Rules that matter:
- Orders are simulated. POST /v1/orders answers 202 {orderId, status: "pending"}; poll GET /v1/orders/{orderId} until
  filled / rejected. A rejection names the rule (reject_rule).
- Equity-based daily loss limit and max drawdown: crossing either ENDS the account. Read GET /v1/accounts/me/rules
  and GET /v1/accounts/me/limits before sizing anything.
- One trade may commit at most a set share of the balance (margin for perps). /limits returns the largest order
  each market accepts right now.
- Send a fresh Idempotency-Key with every order. Never resend a failed order without checking it was not placed.
- Limits: 600 reads and 60 writes per minute; on 429 wait Retry-After seconds.
- Numeric database columns come back as strings.
Always show the user the order (market, side, size, leverage, stop) and wait for their OK before placing it.