Skip to main content

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.

All market prices are quoted as probabilities (0.00 to 1.00), but amounts are in your chosen currency.

Supported currencies

  • USD — US Dollar (default).
  • NGN — Nigerian Naira.

Currency base multiplier

Each currency has a base multiplier that determines how probabilities convert to costs:
CurrencyBase multiplierPrice of 0.65Winning payout
USD1$0.65/share$1.00/share
NGN100₦65.00/share₦100.00/share
The cost per share is: price × base multiplier. Losing shares pay out 0.00.

Specifying currency

Add the currency query parameter to your requests:
# Get events with prices in NGN
GET /v1/pm/events?currency=NGN

# Get a specific event in USD (default)
GET /v1/pm/events/evt_123?currency=USD

# Place an order in NGN
POST /v1/pm/events/evt_123/markets/mkt_456/orders
{
  "side": "BUY",
  "outcome": "YES",
  "amount": 10000,
  "currency": "NGN"
}
If you don’t specify a currency, USD is used by default.

Base multiplier vs. exchange rate

The base multiplier applies to trading amounts — share prices, order costs, and display values. It converts probabilities to currency-denominated costs (e.g., a price of 0.65 costs 65.00 NGN per share). The following are converted from USD using the live exchange rate, not the base multiplier:
  • Liquidity reward and maker rebate payouts
  • Eligibility thresholds like minNotionalOrderSize and minPayoutUsd (evaluated in USD internally, then converted at the current rate)