polymerdao/polymer-pay-dome

Dome

Dome API provides comprehensive access to prediction market data across multiple platforms including Polymarket and Kalshi. Access real-time prices, orderbooks, trades, and market data through the Polymer Pay proxy. No API key needed — payment is handled automatically.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Get Polymarket Market Price

Fetches the current market price for a Polymarket market by token_id.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/market-price/{token_id}",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with current market price (yes/no prices).

Get Polymarket Markets

Find markets on Polymarket using various filters.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/markets",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "search": "bitcoin",
    "status": "open",
    "limit": 10
  }
}

Response: JSON with array of market objects.

Get Polymarket Orderbook

Fetches historical orderbook snapshots for a Polymarket market.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/orderbooks",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "token_id": "12345"
  }
}

Response: JSON with orderbook data including bids and asks.

Get Polymarket Wallet Positions

Fetches all Polymarket positions for a wallet address.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/positions/wallet/{wallet_address}",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "limit": 100
  }
}

Response: JSON with positions including market info, balance, and value.

Get Polymarket Wallet Info

Fetches wallet information by EOA or proxy address.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/wallet",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "eoa": "0x1234567890abcdef"
  }
}

Response: JSON with wallet info and optional trading metrics.

Get Polymarket Activity

Fetches activity data for a specific user.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/activity",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "user": "0x1234567890abcdef",
    "limit": 50
  }
}

Response: JSON with trading activity (MERGES, SPLITS, REDEEMS).

Get Polymarket Candlesticks

Fetches historical candlestick data for a market.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/candlesticks/{condition_id}",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "start_time": 1704067200,
    "end_time": 1704153600,
    "interval": 60
  }
}

Response: JSON with OHLCV candlestick data.

Get Polymarket Wallet PnL

Fetches realized profit and loss for a wallet.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/wallet/pnl/{wallet_address}",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "granularity": "day"
  }
}

Response: JSON with realized PnL data.

Get Polymarket Orders

Fetches historical trade data for a user.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/polymarket/orders",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "user": "0x1234567890abcdef",
    "limit": 50
  }
}

Response: JSON with historical order data.

Get Kalshi Market Price

Fetches the current market price for a Kalshi market.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/kalshi/market-price/{market_ticker}",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with yes/no prices for the market.

Get Kalshi Markets

Find markets on Kalshi.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/kalshi/markets",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "search": "bitcoin",
    "status": "open",
    "limit": 10
  }
}

Response: JSON with Kalshi market listings.

Get Kalshi Orderbook

Fetches orderbook snapshots for a Kalshi market.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/kalshi/orderbooks",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "ticker": "BITCOIN-250331"
  }
}

Response: JSON with orderbook data.

Get Kalshi Trades

Fetches historical trade data for Kalshi markets.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/kalshi/trades",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "ticker": "BITCOIN-250331",
    "limit": 50
  }
}

Response: JSON with trade history.

Get Matching Sports Markets

Find equivalent markets across platforms.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/matching-markets/sports",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "polymarket_market_slug": ["bitcoin-will-hit-100k"]
  }
}

Response: JSON with matching markets from different platforms.

Get Crypto Prices (Binance)

Fetches historical crypto price data from Binance.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/crypto-prices/binance",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "currency": "btcusdt"
  }
}

Response: JSON with Binance price data.

Get Crypto Prices (Chainlink)

Fetches historical crypto price data from Chainlink.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/dome/crypto-prices/chainlink",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "params": {
    "currency": "btc/usd"
  }
}

Response: JSON with Chainlink price data.

When to Use

• Market prices — User wants current Polymarket or Kalshi market prices
• Orderbooks — User needs bid/ask data for prediction markets
• Wallet positions — User wants to check their Polymarket positions
• Historical data — User needs trade history, candlesticks, or PnL data
• Sports betting — User wants to find equivalent markets across platforms
• Crypto prices — User wants Binance or Chainlink price data

Best Practices

• Use token_id for Polymarket — Required param for most Polymarket endpoints
• Filter by status — Use status=open to get active markets only
• Set time ranges — For historical data, specify start_time and end_time in Unix timestamps
• Check volume — Use min_volume filter to find liquid markets
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting