For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/execute-modify-triggers.md.

Execute a prepared TP/SL modify

Organization tokenNo token

POST
/orders/modify/{id}/execute

Submits the client's signature over the payload POST /orders/modify/{id}/prepare returned. Each order reports the trigger price it now rests at, or the venue's error when it refused that order, for example a trigger that already fired; refused orders keep their previous trigger. A prepared modify is single-use: an unknown or spent id returns 404.

Rate limit: counts against the Orders limit, 10 a second and 120 a minute (user token, per user); 100 a second and 1,200 a minute (organization api key, per organization). See Rate limits.

Authorization

bearerAuth
headerAuthorizationBearer <JWT>

An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.

Path Parameters

id*string

The batch id prepared with POST /orders/modify/{id}/prepare

Formatuuid

Header Parameters

TM-On-Behalf-Of?string

Act as one of your organization's users. The value is the user_id returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: 400 for a personal token, a repeated header or a non-UUID, 403 for a user outside your organization. Not accepted on organization-scoped routes.

Formatuuid

Request Body

application/json
  1. body

Request to execute an order that is in initialized status. The client must sign each payload returned by the create endpoint and submit the signatures in the same order.

signatures*array<string>

One stamp per payload, in the same order as the payloads returned by the create endpoint. With auth_type: api_key, an entry is the base64url encoding, without padding, of the JSON {"publicKey": "<compressed P-256 public key, hex>", "signature": "<DER signature, hex>", "scheme": "SIGNATURE_SCHEME_TK_API_P256"}, signed as UnsignedPayload describes. With auth_type: web_authn, an entry is the browser's WebAuthn stamp.

Items1 <= items
auth_type*SigningMethod

The authentication method used to sign transaction payloads.

  • web_authn — Signed using a passkey (WebAuthn/FIDO2 credential) via the browser.
  • api_key — Signed using an API key. Suitable for programmatic/headless access.
Value in"web_authn""api_key"

Response Body

Each order's outcome

application/json
  1. response
orders?array<>

Each order's outcome, in the prepared order.

Example Request
curl -X POST 'https://api.truemarkets.co/v1/gateway/orders/modify/497f6eca-6276-4993-bfeb-53cbbbba6f08/execute' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \  -H 'Content-Type: application/json' \  -d '{  "signatures": [    "string"  ],  "auth_type": "api_key"}'
Example Response
{  "orders": [    {      "order_id": "93101167-9065-4b9c-b98b-5d789a3ed9fe",      "trigger_price": "string",      "error": "string"    }  ]}