> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pitchmarket.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# PitchMarket

> A football prediction exchange on Solana — off-chain matching, on-chain non-custodial settlement.

PitchMarket is a football prediction exchange on Solana. Users trade binary outcome
markets on live football fixtures priced from the TxLINE data feed. Matching is off-chain
for speed; money moves on-chain, non-custodially, per cryptographically signed orders.

## The one-paragraph pitch

Your funds are safe during trading because the settlement contract moves them only per an
order **you** signed, at a price at least as good as your limit. The operator matches
orders and pays gas, but it can never forge a trade, over-fill your order, or take
custody. Matching is off-chain (snappy, no wallet popup per trade); settlement, resolution,
and redemption are on-chain on Solana devnet.

## What exists

<CardGroup cols={2}>
  <Card title="Architecture" icon="sitemap" href="/architecture">
    How the on-chain program, backend service, web frontend, and mobile app fit together.
  </Card>

  <Card title="Matching engine" icon="arrows-left-right" href="/concepts/matching">
    The fully-collateralized CTF model and the three match types: NORMAL, MINT, MERGE.
  </Card>

  <Card title="On-chain program" icon="link" href="/onchain/program">
    Accounts, instructions, and the exact settle\_match transaction layout.
  </Card>

  <Card title="REST & WebSocket API" icon="server" href="/api/rest">
    The full off-chain surface the frontend and bots trade through.
  </Card>
</CardGroup>

## Products

| Product             | What it is                                                                                   | Settlement                                                                                                                                    |
| ------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Binary markets**  | YES/NO outcome markets per fixture template (e.g. draw-no-bet, over/under)                   | Fully on-chain: signed order → operator crank → `settle_match` → `resolve_market` → `redeem`                                                  |
| **Combos (RFQ)**    | Parlays: taker holds "all N legs win", an MM quotes the other side                           | Off-chain in the current build, behind an interface seam; the on-chain `combo_accept`/`resolve_combo` path is designed (ADR 0004) but stubbed |
| **Precision pools** | Guess a match stat exactly; pool-based, winners paid by losers, σ-normalized closeness score | Off-chain (Tier 2 by design, ADR 0006)                                                                                                        |

## The trustless floor

The core on-chain settlement path is deployed on Solana devnet at the pinned program ID
`3fdgRPcZnwWcaGi197dkZDyq24VHoWJcGzKTVfMxNPWs`. A full lifecycle — signed order → engine
match → operator crank `settle_match` (v0 transaction + address lookup table) →
`resolve_market` → 1:1 `redeem` — runs end to end with balance assertions.

Start with [Architecture](/architecture) for the system map, or jump to the
[Matching engine](/concepts/matching) and [On-chain program](/onchain/program) for the
mechanics.