OddMaki Subgraph

The Graph subgraph for the OddMaki Protocol — indexes all on-chain events from the Diamond proxy into a queryable GraphQL API.

Entities

Entity	Description
Venue	Venue configuration, fees, access control, statistics
Market	Market lifecycle, outcomes, pricing, resolution
MarketGroup	Mutually exclusive market bundles (neg-risk)
Order	Limit orders with status tracking
Trade	Market-level trade events (fills, mints, merges, market orders)
Fill	Per-participant fill records with cost and fees
TraderPosition	Position tracking with P&L (entry price, realized P&L)
TopOfBook	Best bid/ask per outcome
Question / Assertion	UMA oracle resolution lifecycle
PriceMarket	Pyth price feed market overlay
Protocol	Protocol-wide aggregate statistics
VenueDailySnapshot	Daily venue analytics

See schema.graphql for the full schema and QUERIES.md for example queries.

Networks

Network	Manifest	Status
Base Sepolia	subgraph.base-sepolia.yaml	Deployed
Base Mainnet	subgraph.yaml	Pending

See docs/the-graph-network-deployment.md for the plan to publish to The Graph Network (GRT).

Development

pnpm install
pnpm run codegen
pnpm run build

Local Development (Anvil + Graph Node)

# Start Graph Node
pnpm run graph-node:up

# Deploy subgraph locally
pnpm run codegen && pnpm run build
pnpm run create-local && pnpm run deploy-local

# Query at http://localhost:8900/subgraphs/name/oddmaki/graphql

Deploy to The Graph Studio

# Authenticate (one-time)
graph auth --studio <DEPLOY_KEY>

# Deploy to Base Sepolia
pnpm run deploy-base-sepolia

# Deploy to Base Mainnet
pnpm run deploy-base

Related

• oddmaki-core — Smart contracts
• oddmaki-sdk — TypeScript SDK
• oddmaki-venue-starter — Venue starter template

Links

• Protocol — oddmaki.com
• Maintainer — predictablereality.com
• Contact — team@oddmaki.com

License

MIT — Copyright (c) 2025-2026 Predictable Reality, Inc.