Place your first order
Every order is an intent: you compose it, the OMS risk-gates it, then it dispatches. Placing on a paper account runs that entire pipeline with no venue key, so you end up with a filled order and a position you can read back.
-
Compose the order on paper
Section titled “Compose the order on paper”venue,symbol,side,typeandqtyare the only required fields.typeis one ofmarket,limit,stop,stop_limit,take_profit. Every account trades paper today, sovenueis always"paper"; any other venue answers403 {"error":"live_accounts_disabled"}. See Paper-only mode.Terminal window curl -s https://api.troncharts.xyz/api/v1/oms/intents \-H "authorization: Bearer $TOKEN" \-H "x-tenant-slug: $TC_TENANT_SLUG" \-H 'content-type: application/json' \-H "idempotency-key: $(uuidgen)" \-d '{"venue":"paper","symbol":"BTC.HL","side":"buy","type":"market","qty":"0.01","accountId":"'"$ACCOUNT_ID"'"}'const { intentId, state, syncFill } = await sdk.oms.composeIntent({ venue: 'paper', symbol: 'BTC.HL', side: 'buy', type: 'market', qty: '0.01', accountId },crypto.randomUUID(), // idempotency key — retries replay instead of re-firing) -
Read the fill off the response
Section titled “Read the fill off the response”The paper engine matches synchronously, so the
201already carries the outcome.intentIdis the handle for every call after this one.{ "intentId": "3f2a…", "state": "filled","syncFill": { "qty": "0.01", "avgPrice": "64210.5" } } -
Rest a limit order
Section titled “Rest a limit order”Type-specific fields are enforced at compose:
limitneedsprice, the trigger types needtriggerPrice. On paper astop_limittakes its resting limit frompriceand ignoresstopLimitPrice. A limit away from the market comes back withoutsyncFilland stays working.Terminal window curl -s https://api.troncharts.xyz/api/v1/oms/intents \-H "authorization: Bearer $TOKEN" \-H 'content-type: application/json' \-H "idempotency-key: $(uuidgen)" \-d '{"venue":"paper","symbol":"BTC.HL","side":"buy","type":"limit","qty":"0.01","price":"60000","timeInForce":"Gtc"}'const { intentId } = await sdk.oms.composeIntent({ venue: 'paper', symbol: 'BTC.HL', side: 'buy', type: 'limit',qty: '0.01', price: '60000', timeInForce: 'Gtc' },crypto.randomUUID(),) -
Follow the order
Section titled “Follow the order”Subscribe to
Order-Intent-Changedon/ws/riskbefore you place, and matchOrder-Intent-Updateframes on theintentId: they carry every state change up to the terminal one (filled,rejected,canceled). To read the working book over REST, list the account’s open orders; thevenueOrderIdthere is whatPOST /api/v1/oms/canceltakes.Terminal window curl -s https://api.troncharts.xyz/api/v1/accounts/$ACCOUNT_ID/orders \-H "authorization: Bearer $TOKEN"
Next: Attach a take-profit and stop-loss · Cancel an order or close a position · Orders & OMS