Developer API

There's no REST backend here — tumaza is fully on-chain. Reads go through the subgraph; writes go directly to the contracts. Anyone can build a bot or integration against either.

Contracts aren't deployed yet — addresses below are placeholders until then.

1. Reads — the subgraph (GraphQL)

Markets, trades, positions, the leaderboard, and resolution state are all indexed here.

(subgraph not deployed yet)

MarketQuestion, category, price, volume, liquidity, status, outcome.

TradeEvery buy/sell: side, shares, cost, price after, timestamp.

PositionA trader's shares + cost basis in a specific market.

TraderPer-wallet aggregates: volume, realized P&L, trade count — powers the leaderboard.

ProposalThe optimistic-oracle lifecycle: proposer, bond, disputer, votes, final outcome.

query {
  markets(first: 20, orderBy: volume, orderDirection: desc) {
    id question: metadataCID status priceYes volume
  }
  traders(first: 10, orderBy: realizedPnl, orderDirection: desc) {
    id realizedPnl totalVolume tradeCount
  }
}

2. Writes — the contracts directly

Trading, proposing outcomes, disputing, and voting are all plain contract calls — no API key, no backend, just a wallet and gas. Deployed on Polygon Amoy (chain ID 80002).

MarketFactorynot deployed yet

OptimisticOraclenot deployed yet

USDC (collateral)not deployed yet

RPC: https://polygon-amoy-bor-rpc.publicnode.com