Trades

Reject a trade intent

Reject a pending intent (atomic CAS). Optional reason. Requires trade scope. 404 if not found or not pending.

post/v1/trades/{id}/reject

Request

  • Base URL: https://api.marketintell.ai
  • URL: https://api.marketintell.ai/v1/trades/{id}/reject
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Opt-in idempotency token (max 255 chars). The FIRST request carrying a given key is processed normally and its 2xx response is cached for 24h, scoped to (api_key + method + path + request-body hash). A retry with the SAME key and body replays the cached response and adds Idempotency-Replayed: true. Reusing the same key with a DIFFERENT body returns 422 (idempotency_key_reuse). The cache is per-process and in-memory, so on a multi-replica deploy a retry that lands on a different task re-executes — callers must already tolerate at-least-once delivery.

Request body

reasonstring

Response

Intent rejected

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.