POST
/
order
/
market
Create a market order
curl --request POST \
  --url https://router-gateway-v3-production.up.railway.app/order/market \
  --header 'Content-Type: application/json' \
  --data '
{
  "quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fromAddress": "<string>",
  "toAddress": "<string>",
  "idempotencyKey": "<string>",
  "refundAuthorizer": "<string>",
  "refundAddress": "<string>",
  "integrator": "<string>",
  "refundMode": "evmSignature",
  "amountFormat": "readable"
}
'
{
  "orderId": "00000000-0000-4000-8000-000000000002",
  "orderAddress": "bc1q2p8ms86h3namagp4y486udsv4syydhvqztg886",
  "amountToSend": "10",
  "quoteId": "00000000-0000-4000-8000-000000000001",
  "orderType": "market_order",
  "from": "Bitcoin.BTC",
  "to": "Ethereum.USDC",
  "status": "quoted",
  "expiry": "2026-05-04T12:10:00Z",
  "estimatedOut": "100000",
  "venues": [
    "velora",
    "across",
    "hyperliquid_bridge",
    "hyperliquid_spot",
    "unit"
  ],
  "fees": [
    {
      "kind": "hyperliquid_core_activation_fee",
      "label": "Hyperliquid activation fee",
      "asset": "Hyperliquid.USDC",
      "amount": "1",
      "amountRaw": "1000000"
    }
  ],
  "amountFormat": "readable",
  "refundMode": "evmSignature",
  "refundAuthorizer": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "refundToken": "rgt_abcdefghijklmnopqrstuvwxyz"
}

Body

application/json
​
quoteId
string<uuid>
required
​
fromAddress
string
required
Required string length: 1 - 128
​
toAddress
string
required
Required string length: 1 - 128
​
idempotencyKey
string
required
Required string length: 16 - 128
Pattern: ^[A-Za-z0-9._:-]+$
​
refundAuthorizer
string | null
required
Required string length: 1 - 128
​
refundAddress
string
Required string length: 1 - 128
​
integrator
string
Required string length: 1 - 128
​
refundMode
enum<string>
default:evmSignature
Available options:
evmSignature,
token
Example:

"evmSignature"

​
amountFormat
enum<string>
default:readable
Available options:
readable,
raw
Example:

"readable"

Response

Order created by the internal router API.

​
orderId
string
required
Example:

"00000000-0000-4000-8000-000000000002"

​
orderAddress
string
required
Example:

"bc1q2p8ms86h3namagp4y486udsv4syydhvqztg886"

​
amountToSend
string
required
Example:

"10"

​
quoteId
string
required
Example:

"00000000-0000-4000-8000-000000000001"

​
orderType
enum<string>
required
Available options:
market_order
Example:

"market_order"

​
from
string
required
Example:

"Bitcoin.BTC"

​
to
string
required
Example:

"Ethereum.USDC"

​
status
string
required
Example:

"quoted"

​
expiry
string
required
Example:

"2026-05-04T12:10:00Z"

​
estimatedOut
string
required
Example:

"100000"

​
venues
string[]
required

Ordered provider ids for the route transitions used by this quote.

Example:
[
  "velora",
  "across",
  "hyperliquid_bridge",
  "hyperliquid_spot",
  "unit"
]
​
fees
object[]
​
amountFormat
enum<string>
default:readable
Available options:
readable,
raw
Example:

"readable"

​
refundMode
enum<string>
default:evmSignature
Available options:
evmSignature,
token
Example:

"evmSignature"

​
refundAuthorizer
string | null
Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

​
refundToken
string
Example:

"rgt_abcdefghijklmnopqrstuvwxyz"