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

# Introduction

> Forecast where Bitcoin settles each week, as a full distribution, and get scored on calibration.

VibeKast runs one market a week: **where will Bitcoin settle on Sunday at 23:59 UTC?** Instead of a yes/no bet or a long/short position, you trade the whole shape of the outcome. The price range is split into 26 ranges, each range trades as a share that pays 1 tUSDC if Bitcoin settles inside it, and the prices of all 26 shares add up to the market's probability distribution.

Everything runs on **Base Sepolia testnet** with free test tokens. Settlement uses Chainlink's BTC/USD feed, with no operator in the loop.

> **[Quickstart](/quickstart)**
>
> Place your first forecast from code in five minutes.

> **[How markets work](/concepts/markets)**
>
> Ranges, prices, fees and settlement.

> **[TypeScript SDK](/sdk/overview)**
>
> `@vibekast/sdk`: a typed client and a viem trader.

> **[MCP server](/mcp)**
>
> Give any MCP-capable agent the same capabilities as tools.

## Ways to take part

> **[Trade in the app](https://www.vibekast.xyz/trade)**
>
> Draw your forecast on the chart and confirm it.

> **[Run an agent](/sdk/trader)**
>
> Forecast every week from your own key, with the SDK or MCP.

> **[Read the data](/api-reference/introduction)**
>
> Markets, trades, wallets and standings over a public REST API.

## The short version

| | |
| - | - |
| Question | Bitcoin's settlement price for the week |
| Close | Sunday 23:59 UTC; a new market opens Monday |
| Outcomes | 26 price ranges centred on the spot price when the market opens |
| Payout | 1 tUSDC per share of the range Bitcoin settles in |
| Market maker | Standard multi-outcome LMSR, liquidity parameter b = 800 |
| Settlement | Time-weighted average of the Chainlink BTC/USD feed over the final two hours |
| Chain | Base Sepolia (chain ID 84532) |
| Collateral | tUSDC, a free test token anyone can mint |
| Scoring | Season points based on CRPS skill, so calibration counts, not volume |

> [!NOTE]
>
> VibeKast is on testnet. tUSDC and test ETH have no value, and the contracts have been self-tested but not yet independently audited.

## For AI tools

These docs are also published as plain text at `/llms.txt` and `/llms-full.txt` on this site, and every page has a copy-as-Markdown button. The app serves its own summary at [`vibekast.xyz/llms.txt`](https://www.vibekast.xyz/llms.txt) and the full API spec at [`vibekast.xyz/openapi.json`](https://www.vibekast.xyz/openapi.json).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.