Oracle Prediction Market API

Developer documentation for integrating with the Oracle prediction market platform.

Contents

• REST API Reference - Full endpoint documentation
• WebSocket Guide - Real-time market data feeds
• Builder Integration - Third-party frontend integration via EIP-712 signing + session cookies
• Deposits & Withdrawals - Funding flow: USDG on Robinhood Chain
• Liquidity Provision - Maker rebates, liquidity rewards (extended quadratic: depth + gold band + uptime weighting + per-wallet cap), claim flow

Quick Start

Base URLs (mainnet parti.com / testnet staging): - Gateway (REST): https://oracle-api.parti.com / https://oracle-gateway.pbcapps.dev - WebSocket: wss://oracle-api.parti.com/v1/ws / wss://oracle-gateway.pbcapps.dev/v1/ws - Deposit Service: https://oracle-deposit.parti.com / https://deposit-staging.parti-oracle.pbcapps.dev - Swagger: https://oracle-api.parti.com/swagger-ui/

Key Concepts: - Prices are in basis points (1-9999). 5000 = $0.50, 7500 = $0.75. - Market IDs are a bytes32 slot: a 64-char hex id verbatim, else SHA-256 of the utf-8 slug. - User addresses are 0x EVM addresses on Robinhood Chain (chain id 4663 mainnet / 46630 testnet), lowercase on the wire. - Writes authenticate with a session cookie + an EIP-712 signature under the PartiVault domain. - Balances are in micro-USDG (6 decimals). 1,000,000 = $1.00. The settled token is USDG.

Example: Place an order (needs the session cookie from /v1/builders/register — see Builder Integration)

curl -X POST ${GATEWAY}/v1/orders \
  -H "Content-Type: application/json" \
  -H "Cookie: ${SESSION_COOKIE}" \
  -d '{
    "market_id": "a1b2c3...",
    "user": "0x4b2a9e7c...",
    "side": "buy",
    "outcome": "yes",
    "price": 6500,
    "size": 100,
    "order_type": "gtc",
    "signature": "0x<65-byte EIP-712 Order signature>",
    "nonce": 1700000000123
  }'