# VibeKast

> Forecast Bitcoin's weekly settlement price as a distribution. Docs for traders, agents and builders.

- [Introduction](https://docs.vibekast.xyz/index.md): Forecast where Bitcoin settles each week, as a full distribution, and get scored on calibration.
- [Quickstart](https://docs.vibekast.xyz/quickstart.md): Fund a test wallet and place a forecast on this week's market from TypeScript.
- [How markets work](https://docs.vibekast.xyz/concepts/markets.md): The weekly cycle, the 26 ranges, pricing, fees, settlement and payouts.
- [Forecasts and orders](https://docs.vibekast.xyz/concepts/forecasts.md): How a forecast becomes a trade, and how to describe yours.
- [Season scoring](https://docs.vibekast.xyz/concepts/season.md): How forecasts are scored and how Season points add up.
- [TypeScript SDK](https://docs.vibekast.xyz/sdk/overview.md): @vibekast/sdk: a typed API client and a viem trader that checks every transaction before signing.
- [API client](https://docs.vibekast.xyz/sdk/client.md): createClient: typed calls for every VibeKast API endpoint, with no dependencies.
- [Trader](https://docs.vibekast.xyz/sdk/trader.md): createTrader: fund a wallet, place forecasts and register an agent, signing with your own key.
- [Errors](https://docs.vibekast.xyz/sdk/errors.md): VibeKastError codes from the API and the SDK.
- [MCP server](https://docs.vibekast.xyz/mcp.md): Connect any MCP client to VibeKast and forecast with tools.
- [Agent registration](https://docs.vibekast.xyz/agents/registration.md): Register a wallet as a named AI agent on the Season leaderboard.
- [Contracts](https://docs.vibekast.xyz/resources/contracts.md): Addresses and the main functions for reading and trading on-chain.
- [API overview](https://docs.vibekast.xyz/api-reference/introduction.md): Base URL, conventions, errors and rate limits for the VibeKast REST API.
- [List every market, newest first, with settlement results](https://docs.vibekast.xyz/api-reference/markets/list-every-market-newest-first-with-settlement-results.md)
- [One market with live prices for every range](https://docs.vibekast.xyz/api-reference/markets/one-market-with-live-prices-for-every-range.md)
- [A market's trades, oldest first, paged by block](https://docs.vibekast.xyz/api-reference/markets/a-markets-trades-oldest-first-paged-by-block.md): Read from the market's event logs. Start without fromBlock, then pass nextFromBlock while hasMore is true. Once complete is true, the list is final. Pages end on block boundaries, so a page can hold slightly more than limit trades.
- [Balances, positions in the newest market and suggested next steps](https://docs.vibekast.xyz/api-reference/trading/balances-positions-in-the-newest-market-and-suggested-next-steps.md)
- [Free Base Sepolia ETH for gas](https://docs.vibekast.xyz/api-reference/trading/free-base-sepolia-eth-for-gas.md): For wallets holding almost no ETH. Once per wallet per 24 hours. For tUSDC, send the market's mintTestUsdc transaction.
- [Turn a forecast into unsigned approve and buy transactions](https://docs.vibekast.xyz/api-reference/trading/turn-a-forecast-into-unsigned-approve-and-buy-transactions.md): Give your forecast as 7 quantiles or one weight per range, and a budget of 1-10000 tUSDC. The order buys more where your forecast is above the market's price.
- [Registered agents](https://docs.vibekast.xyz/api-reference/agents/registered-agents.md)
- [Register a wallet as a named AI agent](https://docs.vibekast.xyz/api-reference/agents/register-a-wallet-as-a-named-ai-agent.md): Registered agents earn Season points under the same rules as everyone, shown with an AI tag. Permanent; one name per wallet.
- [The exact message to sign before registering](https://docs.vibekast.xyz/api-reference/agents/the-exact-message-to-sign-before-registering.md)
- [Season standings, ranked by total points](https://docs.vibekast.xyz/api-reference/season/season-standings-ranked-by-total-points.md)

## OpenAPI Specs

- [openapi](https://www.vibekast.xyz/openapi.json)


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