broker-openapi

Amend (modify) order

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/tie-tech/hub/b2b-api/doc/broker-openapi/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "broker-openapi MCP server": {
    "url": "https://bump.sh/tie-tech/hub/b2b-api/doc/broker-openapi/mcp"
  }
}
Close
PATCH /trading/accounts/{account_id}/orders
Api key auth

Modify order parameters (Price/Qty).

  • Targeting: Requires market_id and either order_id OR client_order_id.
  • Stable Identity: client_order_id is immutable and used only for targeting.
  • Priority Logic:
    • price change OR qty increase → priority reset (order repositioned)
    • qty decrease (and unchanged price) → priority preserved
  • Idempotency: Guaranteed by Idempotency-Key.

Headers

  • PRE-ACCESS-KEY string Required

    Broker access key identifier.

    Format should match the following pattern: ^[A-Za-z0-9._~-]{1,64}$.

  • PRE-ACCESS-SIGNATURE string Required

    Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).

    Format should match the following pattern: ^[0-9a-f]{64}$.

  • PRE-ACCESS-TIMESTAMP string(date-time) Required

    RFC3339 timestamp with milliseconds (e.g., 2025-10-30T06:00:34.075Z). Must be within clock_skew_tolerance (default 5m) of server time.

  • Idempotency-Key string Required

    Stable idempotency token reused on retries. Reuse with identical payload => 202. Reuse with different payload => 409 idempotency_key_mismatch.

    Maximum length is 64. Format should match the following pattern: ^[A-Za-z0-9._~-]{1,64}$.

  • Correlation-Id string

    Optional UUIDv7 correlation identifier (lowercase). Must match RFC4122 UUIDv7 (version nibble '7', variant 8|9|a|b). If present but invalid → 422 invalid_correlation_id (error_code).

    Format should match the following pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$.

Path parameters

  • account_id string Required

    Broker-supplied account identifier; length 1..128; charset [A-Za-z0-9._~-].

    Maximum length is 128. Format should match the following pattern: ^[A-Za-z0-9._~-]{1,128}$.

application/json

Body Required

  • market_id string Required

    Required for routing

  • order_id string(uuid)

    Target order ID (preferred)

  • client_order_id string

    Target client order ID (fallback)

  • price object
    Hide price attributes Show price attributes object
    • units integer(int64) Required
    • nanos integer(int32) Required

      Minimum value is -999999999, maximum value is 999999999.

  • qty object
    Hide qty attributes Show qty attributes object
    • units integer(int64) Required
    • nanos integer(int32) Required

      Minimum value is -999999999, maximum value is 999999999.

Responses

  • 200 application/json

    Amend command accepted

    Any of:
    object-1 object object-2 object
  • 202 application/json

    Idempotent replay

    Any of:
    object-1 object object-2 object
  • 404 application/json

    Resource not found

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.
  • 409 application/json

    Idempotency-Key reused with different payload

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.
  • 422 application/json

    Validation / semantic error

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.
  • 503 application/json

    Backpressure / temporary unavailability

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.
PATCH /trading/accounts/{account_id}/orders 
curl \
 --request PATCH 'https://api.example.com/v1/trading/accounts/{account_id}/orders' \
 --header "Content-Type: application/json" \
 --header "PRE-ACCESS-KEY: string" \
 --header "PRE-ACCESS-SIGNATURE: string" \
 --header "PRE-ACCESS-TIMESTAMP: 2026-05-04T09:42:00Z" \
 --header "Idempotency-Key: string" \
 --header "Correlation-Id: string" \
 --data '{"market_id":"string","order_id":"string","client_order_id":"string","price":{"units":42,"nanos":42},"qty":{"units":42,"nanos":42}}'
Request examples 
# Headers
PRE-ACCESS-KEY: string
PRE-ACCESS-SIGNATURE: string
PRE-ACCESS-TIMESTAMP: 2026-05-04T09:42:00Z
Idempotency-Key: string
Correlation-Id: string

# Payload
{
  "market_id": "string",
  "order_id": "string",
  "client_order_id": "string",
  "price": {
    "units": 42,
    "nanos": 42
  },
  "qty": {
    "units": 42,
    "nanos": 42
  }
}
Response examples (200) 
{
  "order_id": "string",
  "client_order_id": "string"
}
{
  "order_id": "string",
  "client_order_id": "string"
}
Response examples (202) 
{
  "order_id": "string",
  "client_order_id": "string"
}
{
  "order_id": "string",
  "client_order_id": "string"
}
Response examples (404) 
{
  "error_code": "string",
  "message": "string",
  "details": {}
}
Response examples (409) 
{
  "error_code": "string",
  "message": "string",
  "details": {}
}
Response examples (422) 
{
  "error_code": "string",
  "message": "string",
  "details": {}
}
Response examples (503) 
{
  "error_code": "string",
  "message": "string",
  "details": {}
}