All endpoints below are mounted under /v1 on the validator API (https://api.minotaursubnet.com). The CORS allowlist covers https://app.minotaursubnet.com.

POST /v1/apps/{app_id}/orders

Submit a new order to the Intent OrderBook.

Path parameters

• app_id — str (required)

Request body

• req — SubmitOrderRequest (required) (model SubmitOrderRequest)
  • intent_function: str = 'execute'
  • params: dict[str, Any] = {}
  • submitted_by: str
  • chain_id: int = 1
  • deadline: float = 0.0
  • perpetual: bool = False
  • max_executions: int = 1
  • cooldown: float = 0.0
  • user_signature: str = ''

Status code: 201

POST /v1/apps/{app_id}/prepare

Resolve token symbols, chain_id, intent_function, and nonce in one call.

Path parameters

• app_id — str (required)

Request body

• req — PrepareOrderRequest (required) (model PrepareOrderRequest)
  • params: dict[str, Any] = {}
  • submitted_by: str = ''
  • intent_function: str = 'execute'
  • chain_id: int = 1

POST /v1/apps/{app_id}/quote

Get an estimated quote for an intent without creating an order.

Path parameters

• app_id — str (required)

Request body

• req — QuoteRequest (required) (model QuoteRequest)
  • intent_function: str = 'execute'
  • params: dict[str, Any]
  • chain_id: int = 1
  • slippage_bps: int = 50

GET /v1/blockloop/status

Get block loop tick statistics.

GET /v1/orders

List orders — paginated (newest-first) SUMMARY view.

Query parameters

• app_id — str | None
• status — str | None
• limit — int
• offset — int
• full — bool

Headers

• x_reader_sig — str | None

DELETE /v1/orders/{order_id}

Cancel an open order.

Path parameters

• order_id — str (required)

Query parameters

• submitted_by — str
• owner_signature — str
• deadline — int

GET /v1/orders/{order_id}

Get the status of an order.

Path parameters

• order_id — str (required)

Headers

• x_reader_sig — str | None

GET /v1/orders/{order_id}/bridge

Get bridge transfer status for a cross-chain order.

Path parameters

• order_id — str (required)

POST /v1/orders/{order_id}/dry-run

Score a plan against an order without side effects.

Path parameters

• order_id — str (required)

Request body

• req — DryRunRequest (required) (model DryRunRequest)
  • interactions: list[dict[str, Any]]
  • deadline: int = 0
  • nonce: int = 0
  • metadata: dict[str, Any] = {}

POST /v1/orders/{order_id}/prepare-direct

Wait for consensus, return executeIntent calldata for user to submit directly.

Path parameters

• order_id — str (required)

PATCH /v1/orders/{order_id}/signature

Attach a user EIP-712 signature to an existing order.

Path parameters

• order_id — str (required)

PATCH /v1/orders/{order_id}/tx-confirmed

Mark a user-submitted order as FILLED after the user’s TX lands.

Path parameters

• order_id — str (required)