Skip to content

Oracle Prediction Market API

Developer documentation for integrating with the Oracle prediction market platform.

Contents

Quick Start

Base URLs: - Gateway (REST): https://api.parti-oracle.pbcapps.dev - WebSocket: wss://ws.parti-oracle.pbcapps.dev/v1/ws - Signer (builders): https://signer.parti-oracle.pbcapps.dev - Deposit Service: https://deposit.parti-oracle.pbcapps.dev - Swagger: https://api.parti-oracle.pbcapps.dev/swagger-ui/

Key Concepts: - Prices are in basis points (1-9999). 5000 = $0.50, 7500 = $0.75. - Market IDs are hex-encoded 32-byte SHA-256 hashes. - User addresses are Base58-encoded Ed25519 public keys. - Balances are in micro-USDC (6 decimals). 1,000,000 = $1.00.

Example: Place an order

curl -X POST ${GATEWAY}/v1/orders \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": "a1b2c3...",
    "user": "4xR2kF7b...",
    "side": "buy",
    "outcome": "yes",
    "price": 6500,
    "size": 100,
    "order_type": "gtc",
    "signature": "deadbeef...",
    "nonce": 1
  }'