Vibe Coding with Windy

Build financial apps with AI in minutes. Windy Network ships everything an AI coding tool needs to write correct code against our API on the first try.

Materials we ship

Asset	URL	Purpose
llms.txt	/llms.txt	Short, AI-discoverable summary — links to everything else
llms-full.txt	/llms-full.txt	Full API reference in flat markdown — drop into an LLM context window
OpenAPI 3.1 spec	/openapi.yaml	Canonical machine-readable schema
CLAUDE.md template	/CLAUDE.md	Drop into your project root for Claude Code context
Claude Code Skill	windy-network/claude-skill	Packaged skill install
MCP server	windy.network/vibe-coding	One-click install for Claude Code, Cursor, Windsurf, VS Code, Continue, Cline, Zed

The 30-second quickstart

Get an API key: windy.network/pricing.

Drop our CLAUDE.md into your project:

curl -O https://docs.windy.network/CLAUDE.md

Set the key as an env var:
```
export WINDY_API_KEY=wn_...
```
Prompt your AI tool. Paste a prompt from Vibe Coding on the main site or write your own. The AI will read CLAUDE.md + llms-full.txt and produce working code.

Authentication

Two options:

X-API-Key: <WINDY_API_KEY>

or, for OAuth 2.0 flows:

Authorization: Bearer <JWT>

Obtain a JWT from /oauth/token. Most vibe-coding projects should stick with the X-API-Key header.

Why this works

Problem with typical APIs	How Windy fixes it
AI guesses endpoint paths and gets 404s	`llms-full.txt` has every path verbatim
AI hallucinates pagination/auth patterns	Conventions are written down in `CLAUDE.md`
AI can't debug rate-limit errors	`X-RateLimit-*` header docs in `CLAUDE.md`
AI treats prices as floats and loses precision	"Prices are strings" is rule zero
AI picks the wrong category endpoint	Categorization (stablecoin/basecoin/altcoin) is documented

Supported AI coding tools

MCP install cards on windy.network/vibe-coding for:

Claude Code — Anthropic's official CLI + IDE extensions
Cursor — AI-first VS Code fork
Windsurf — Codeium's agentic IDE
VS Code — Copilot Chat + MCP support
Continue — open-source assistant for VS Code + JetBrains
Cline — autonomous coding agent in VS Code
Zed — high-performance editor with native AI

The Windy MCP server is under active development. Install commands go live when it ships.

Prompts that work

See the prompt library on windy.network/vibe-coding for copy-ready prompts:

Live BTC price ticker
Multi-exchange arbitrage scanner
24/7 Forex dashboard (Fiat247)
Portfolio tracker
DEX vs CEX price comparator
Reference-rate widget

Every prompt starts with "first load https://docs.windy.network/llms-full.txt" so the AI grounds itself on the real spec before writing code.

Troubleshooting

AI generates 404s. It's probably guessing paths. Tell it to re-read llms-full.txt before the next attempt.

AI uses Authorization: Bearer <api_key>. That's wrong for API keys. API keys go in X-API-Key:. Authorization: Bearer is reserved for OAuth JWTs.

AI loses price precision in math. Remind it: prices are strings. Only convert to numbers for display or non-order-critical comparisons.

Next steps

Quickstart — full API walkthrough with cURL, Node, Python
API Reference — interactive Scalar OpenAPI explorer
JavaScript SDK — typed client
windy.network/vibe-coding — interactive install hub