Skip to main content
POST
/
v1
/
pm
/
events
/
{eventId}
/
markets
/
{marketId}
/
orders
Place order
curl --request POST \
  --url https://relay.bayse.markets/v1/pm/events/{eventId}/markets/{marketId}/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "side": "<string>",
  "outcomeId": "<string>",
  "amount": 123,
  "type": "<string>",
  "currency": "<string>",
  "price": 123,
  "timeInForce": "<string>",
  "postOnly": true,
  "stpMode": "<string>",
  "maxSlippage": 123,
  "expiresAt": "<string>"
}
'
{
  "engine": "AMM",
  "order": {
    "id": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "outcome": "YES",
    "side": "BUY",
    "type": "MARKET",
    "status": "filled",
    "amount": 100,
    "price": 0.7235,
    "quantity": 138.21,
    "currency": "USD",
    "createdAt": "2026-02-17T12:00:00Z",
    "updatedAt": "2026-02-17T12:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.bayse.markets/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Write authentication required — X-Public-Key, X-Timestamp, and X-Signature headers. See the Authentication guide.

​
Path parameters

​
eventId
string
required
UUID of the event.
​
marketId
string
required
UUID of the market.

​
Request body

​
side
string
required
BUY or SELL.
​
outcomeId
string
required
UUID of the outcome. Use the Get Event endpoint to find outcome IDs.
​
amount
number
required
Amount to spend (buy) or receive (sell), in the specified currency. Minimum: $1.00 USD / ₦100.00 NGN.
​
type
string
required
LIMIT or MARKET.
​
currency
string
USD (default) or NGN.
​
price
number
Limit price per share (0.01–0.99). Required for LIMIT orders.
​
timeInForce
string
GTC (good-til-cancelled, default for limit), GTD (good-til-date), FAK (fill-and-kill, default for market), or FOK (fill-or-kill).
​
postOnly
boolean
If true, the order is rejected instead of crossing the spread. Limit orders only. Default: false.
​
stpMode
string
Self-trade prevention mode. Controls how the engine resolves a match against another resting order from the same user. CLOB only. Default: SKIP. Unknown values fall back to SKIP.
  • SKIP — the match is silently skipped and both orders remain on the book.
  • CANCEL_OLDEST — the resting same-user maker is cancelled and refunded; the taker continues matching against other counterparties.
  • CANCEL_NEWEST — the incoming taker stops at the same-user match. If it had already filled against other users, those fills stand and the taker comes back as cancelled; otherwise it is rejected.
  • CANCEL_BOTH — the resting maker is cancelled and the taker is cancelled or rejected under the same rule as CANCEL_NEWEST.
​
maxSlippage
number
Maximum acceptable slippage for market orders (0.00–1.00).
​
expiresAt
string
ISO 8601 expiration timestamp. Required for GTD orders.

​
Example request

PUBLIC_KEY="pk_live_abcdef123456"
SECRET_KEY="sk_live_secret789xyz"
TIMESTAMP=$(date +%s)
METHOD="POST"
URL_PATH="/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890/markets/b2c3d4e5-f6a7-8901-bcde-f12345678901/orders"
BODY='{"side":"BUY","outcomeId":"c3d4e5f6-a7b8-9012-cdef-345678901234","amount":100,"type":"MARKET","currency":"USD"}'

BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 -hex 2>/dev/null | sed 's/.*= //')
PAYLOAD="${TIMESTAMP}.${METHOD}.${URL_PATH}.${BODY_HASH}"
SIGNATURE=$(printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$SECRET_KEY" -binary | base64)

curl -X POST "https://relay.bayse.markets${URL_PATH}" \
  -H "X-Public-Key: ${PUBLIC_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "$BODY"

​
Response

The response contains an engine field indicating the market type, and an order object with the order details.
​
engine
string
AMM or CLOB.
​
order
object
The placed order. Fields vary by engine type.
{
  "engine": "AMM",
  "order": {
    "id": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "outcome": "YES",
    "side": "BUY",
    "type": "MARKET",
    "status": "filled",
    "amount": 100,
    "price": 0.7235,
    "quantity": 138.21,
    "currency": "USD",
    "createdAt": "2026-02-17T12:00:00Z",
    "updatedAt": "2026-02-17T12:00:00Z"
  }
}

​
Replacing market-maker quotes with stpMode

A market maker re-quoting on both sides of a CLOB book risks crossing its own resting orders mid-update. Setting stpMode to CANCEL_OLDEST cancels the stale same-user maker server-side as the new quote arrives, so the new order can continue matching against external counterparties without sitting next to a duplicate of itself.
cURL
BODY='{"side":"BUY","outcomeId":"c3d4e5f6-a7b8-9012-cdef-345678901234","amount":100,"type":"LIMIT","price":0.71,"timeInForce":"GTC","stpMode":"CANCEL_OLDEST","currency":"USD"}'

curl -X POST "https://relay.bayse.markets/v1/pm/events/${EVENT_ID}/markets/${MARKET_ID}/orders" \
  -H "X-Public-Key: ${PUBLIC_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "$BODY"