adona-robot · market data by capacity

Prop firms

From the key to the first order

Six calls, from your server. Your tenant key never reaches a browser, and every refusal answers a code to branch on.

Facts as of 03.11.2026.

  1. Take a prop token

    Your server exchanges your tenant key for a prop token, valid 12 hours, sent as Authorization: Bearer on every other call.

    curl -s -X POST https://api.adona-robot.com/v1/prop/tokens \
      -H "Authorization: Bearer $ADONA_PROP_KEY"
  2. Create a trader

    Your own name for the trader (external_ref), and a display name if you wish. You hold your traders' identities: no address, no password and no mail reach Adona, and your traders sign in with you. The trader exists at once: the answer carries its trader_id, and you find them again by your own name.

    curl -s -X POST https://api.adona-robot.com/v1/prop/traders \
      -H "Authorization: Bearer $PROP_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"external_ref": "your-own-id-42", "display_name": "Trader 42"}'
    
    # the answer (201) carries its trader_id; later, find it by your own name
    curl -s "https://api.adona-robot.com/v1/prop/traders?external_ref=your-own-id-42" \
      -H "Authorization: Bearer $PROP_TOKEN"
  3. Choose a product

    Your products and their rules: the starting balance, the profit target, the drawdown and daily loss limits, the concurrent stop-loss cap.

    curl -s https://api.adona-robot.com/v1/prop/products \
      -H "Authorization: Bearer $PROP_TOKEN"
  4. Open an account

    On one of your products, for that trader. The answer carries the account's rules as they bind it.

    curl -s -X POST https://api.adona-robot.com/v1/prop/traders/$TRADER_ID/accounts \
      -H "Authorization: Bearer $PROP_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"product": "'"$PRODUCT"'"}'
  5. Place an order

    Every opening carries a stop loss and a take profit, and an Idempotency-Key you make for that order: send the same key again after a timeout or a server error, never after IDEMPOTENCY_OUTCOME_UNKNOWN. The answer says the order is in; what it became is read from the trader's positions and executions.

    curl -s -X POST https://api.adona-robot.com/v1/prop/traders/$TRADER_ID/orders \
      -H "Authorization: Bearer $PROP_TOKEN" \
      -H "Idempotency-Key: $(uuidgen)" \
      -H "Content-Type: application/json" \
      -d '{"symbol": "EURUSD", "side": "BUY", "quantity": "'"$LOTS"'",
           "stop_loss_price": "'"$STOP_LOSS"'", "take_profit_price": "'"$TAKE_PROFIT"'"}'
  6. Receive the confirmations

    Your server keeps one socket open on /v1/prop/stream, with the prop token and no Origin header, and relays each execution to its trader only. Without a socket, read the trader's executions.

    # from your server: the prop token in a header, and no Origin
    websocat -H "Authorization: Bearer $PROP_TOKEN" wss://api.adona-robot.com/v1/prop/stream

Next