Skip to main content
POST
/
v1
/
pm
/
events
/
{eventId}
/
markets
/
{marketId}
/
quote
Get quote
curl --request POST \
  --url https://relay.bayse.markets/v1/pm/events/{eventId}/markets/{marketId}/quote \
  --header 'Content-Type: application/json' \
  --data '
{
  "side": "<string>",
  "outcomeId": "<string>",
  "amount": 123,
  "currency": "<string>"
}
'
{
  "price": 0.7235,
  "currentMarketPrice": 0.72,
  "quantity": 138.21,
  "amount": 100,
  "costOfShares": 98.04,
  "fee": 1.96,
  "priceImpactAbsolute": 0.0035,
  "profitPercentage": 38.21,
  "currencyBaseMultiplier": 1,
  "completeFill": true,
  "tradeGoesOverMaxLiability": false
}
Get the expected cost, shares, and fees for a potential trade without committing to it. Provide X-Public-Key to include profit estimates based on your existing position.

​
Authentication

Public — no authentication required. Provide X-Public-Key for personalized profit estimates.

​
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.
​
currency
string
USD (default) or NGN.

​
Example request

curl -X POST \
  "https://relay.bayse.markets/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890/markets/b2c3d4e5-f6a7-8901-bcde-f12345678901/quote" \
  -H "Content-Type: application/json" \
  -d '{"side":"BUY","outcomeId":"c3d4e5f6-a7b8-9012-cdef-345678901234","amount":100,"currency":"USD"}'

​
Response

​
price
number
Average price per share for this trade (0.00–1.00).
​
currentMarketPrice
number
Current market price before this trade executes.
​
quantity
number
Number of shares you will receive.
​
amount
number
Total amount spent (including fee).
​
costOfShares
number
Cost of shares before fee.
​
fee
number
Trading fee charged.
​
priceImpactAbsolute
number
How much this trade moves the market price.
​
profitPercentage
number
Estimated profit percentage if the outcome wins.
​
currencyBaseMultiplier
number
Multiplier applied to convert prices to the requested currency (1 for USD, 100 for NGN).
​
completeFill
boolean
Whether the full amount can be filled at the quoted price (relevant for CLOB markets).
​
tradeGoesOverMaxLiability
boolean
Whether this trade exceeds maximum liability limits.
{
  "price": 0.7235,
  "currentMarketPrice": 0.72,
  "quantity": 138.21,
  "amount": 100,
  "costOfShares": 98.04,
  "fee": 1.96,
  "priceImpactAbsolute": 0.0035,
  "profitPercentage": 38.21,
  "currencyBaseMultiplier": 1,
  "completeFill": true,
  "tradeGoesOverMaxLiability": false
}
Always get a quote before placing an order to confirm the expected cost and shares. The quoted price is indicative — the actual fill price may differ slightly in fast-moving markets.