---
title: "Submit Order (Hosted)"
method: POST
path: "/v0/trade/submit-order"
tags: ["Trading (Hosted)"]
---

# Submit Order (Hosted)

`POST /v0/trade/submit-order`

Submit a signed order to Polymarket or Opinion and return the resulting `Order` with id, fill status, average price, and on-chain tx hash. The `built_order_id` must come from a recent `buildOrderHosted` call and be submitted before its expiry.

For most callers, prefer `createOrderHosted`, which builds, signs, and submits in a single call.

## Request body

- SubmitOrderHostedRequest — Hosted submit-order request. `signature` is the local EIP-712 signature over `BuildOrderHostedResponse.typed_data`.
  - `built_order_id` string, required
  - `signature` string, required — Hex-encoded EIP-712 signature.
  - `pull_signature` string, nullable — Signature for the secondary pull-authorization, required when `pull_typed_data` was returned.
  - `wait` boolean — When `true`, the server waits for on-chain settlement before responding.

## Response `200`

Order accepted by the hosted backend.

- OrderV0 — Hosted-mode `Order` shape. Mirrors `pmxt.Order` so the SDK can return it directly. `tx_hash`, `chain`, and `block_number` populate once execution settles on-chain.
  - `id` string, required
  - `market_id` string, uuid, nullable
  - `outcome_id` string, uuid, nullable
  - `side` 'buy' | 'sell', nullable
  - `type` 'market' | 'limit', nullable
  - `amount` number, nullable
  - `price` number, nullable
  - `filled` number
  - `remaining` number
  - `status` string, required
  - `fee` number, nullable
  - `timestamp` string, nullable
  - `tx_hash` string, nullable — On-chain transaction hash. Null until settled.
  - `chain` string, nullable
  - `block_number` integer, nullable

## Other responses

- `401` — Invalid or missing PMXT API key.
- `410` — `built_order_id` expired before submission. Re-run `buildOrderHosted` and submit again.
- `422` — Invalid signature or malformed payload.

---

[API](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api.md) · [All operations](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pmxt-dev/pmxt-hosted-router-api/revisions/ea5fcf3a6481/schema)