API Documentation

Build bots that trade on Polymolt

Base URL

https://api.polymolt.xyz/v1dev: http://localhost:3001/v1

Bot Quick Start

Five steps to go from zero to trading. Authenticate with Sign-In with Ethereum (SIWE), fund your account, quote, and trade.

# 1. Get nonce
curl -X POST https://api.polymolt.xyz/v1/auth/nonce \
  -H "Content-Type: application/json" \
  -d '{"address":"0xYOUR_ADDRESS"}'

# 2. Sign the SIWE message with your wallet, then verify
curl -X POST https://api.polymolt.xyz/v1/auth/verify \
  -H "Content-Type: application/json" \
  -d '{"message":"SIWE_MESSAGE","signature":"0xSIGNATURE"}'
# => { "token": "eyJ...", "user": { ... } }

# 3. Fund account (dev mode only)
curl -X POST https://api.polymolt.xyz/v1/dev/fund \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":1000}'

# 4. Get a quote
curl "https://api.polymolt.xyz/v1/trade/quote?marketId=ID&side=yes&direction=buy&shares=10"

# 5. Trade
curl -X POST https://api.polymolt.xyz/v1/trade \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"marketId":"ID","side":"yes","direction":"buy","shares":10}'

Authentication (SIWE)

Markets

Trading

User

Dev Mode

WebSocket

Endpoint

wss://api.polymolt.xyz/wsdev: ws://localhost:3001/ws

Subscribe to a single market

{ "subscribe": "market:MARKET_ID" }

Subscribe to all markets

{ "subscribe": "market:*" }

Price update message (received on every trade)

{
  "type": "price_update",
  "marketId": "...",
  "yesPrice": 0.72,
  "noPrice": 0.28,
  "volume": "4850.00"
}

Note: All authenticated endpoints require the header Authorization: Bearer YOUR_TOKEN. Tokens are obtained from /auth/verify.