# Signalium

> AI-resolved prediction markets sourced from X posts. Built on 0G — bets earn yield in Gimo while the market is open.

## Docs

- [Health](https://docs.signalium.site/api-reference/health.md): Liveness probe + subgraph indexer lag.
- [Introduction](https://docs.signalium.site/api-reference/introduction.md): REST API for the web app and judge worker. Bun + Hono. Source of truth for market reads, X-post evaluation, positions, and the cached 0G/USD price.
- [Markets](https://docs.signalium.site/api-reference/markets.md): List, paginate, and fetch market details. Holders + trades per market.
- [Posts](https://docs.signalium.site/api-reference/posts.md): Evaluate an X URL — runs gatekeeper + writer in 0G Compute TEE.
- [Price](https://docs.signalium.site/api-reference/price.md): Cached 0G/USD price feed. CoinGecko upstream, refreshed at most every 6 hours.
- [Users](https://docs.signalium.site/api-reference/users.md): A wallet's positions and trade history.
- [0G integration](https://docs.signalium.site/concepts/0g-integration.md): Which 0G primitives Signalium uses and what each one solves.
- [Architecture](https://docs.signalium.site/concepts/architecture.md): How the web app, API, judge worker, smart contracts, and subgraph fit together.
- [Yield economics](https://docs.signalium.site/concepts/yield-economics.md): How idle stakes earn yield in Gimo, how the 80/20 split is locked at resolve, and why early and late claimers always get the same per-share payout.
- [AIResolver](https://docs.signalium.site/contracts/ai-resolver.md): ECDSA-verifies TEE judge signatures on-chain, then forwards resolve() to the market.
- [GimoAdapter](https://docs.signalium.site/contracts/gimo-adapter.md): IYieldAdapter implementation for Gimo Finance liquid staking. Native 0G in, st0G out, ~3 day unbonding.
- [Contracts overview](https://docs.signalium.site/contracts/overview.md): Mainnet addresses, role gates, factory provisioning model.
- [PredictionMarket](https://docs.signalium.site/contracts/prediction-market.md): Parimutuel YES/NO market clone with optional Treasury wiring and an 80/20 yield split snapshot.
- [Treasury](https://docs.signalium.site/contracts/treasury.md): Generic native-funds custodian for one principal. Holds bet stakes, routes them to yield adapters, recalls them on demand.
- [Development](https://docs.signalium.site/development.md): Monorepo layout, day-to-day commands, and how to develop against testnet without spending real 0G.
- [Signalium](https://docs.signalium.site/index.md): AI-resolved prediction markets sourced from X posts. Built on 0G — bets earn yield in Gimo while the market is open.
- [Deployment](https://docs.signalium.site/ops/deployment.md): How signalium.site + api.signalium.site are deployed and continuously updated.
- [Subgraph](https://docs.signalium.site/ops/subgraph.md): Goldsky subgraph that indexes the factory + per-market events including yield snapshots.
- [Quick start](https://docs.signalium.site/quickstart.md): Clone, install, and boot the Signalium dev stack against live mainnet — under two minutes.

## OpenAPI Specs

- [openapi](https://docs.signalium.site/api-reference/openapi.json)

## Optional

- [Live app](https://signalium.site)
- [API](https://api.signalium.site)
- [GitHub](https://github.com/rstfulzz/signalium)
- [0G docs](https://docs.0g.ai)