# Coinlib

> Coinlib (coinlib.io) is a cryptocurrency market data platform: live prices, charts, and market stats for the top 1,000+ coins, exchange rankings, coin analysis articles, guides, calculators, a crypto-fiat converter, and embeddable price widgets. Market data is synced from CoinMarketCap and CoinGecko roughly every 5 minutes.

Notes for agents:

- **AI agents are welcome here.** See [/for-agents](https://coinlib.io/for-agents) for terms and [/openapi.json](https://coinlib.io/openapi.json) for the machine-readable spec.
- **MCP server:** `https://mcp.coinlib.io` (Streamable HTTP, no auth). Add it to Claude or any MCP client to query Coinlib's analysis, guides, coin FAQs, and calculators conversationally. Tool list at /for-agents.
- **Market data is HTML-only.** Prices, market caps, volumes, rankings, exchange figures, and conversion rates are licensed from CoinMarketCap and CoinGecko under terms that let Coinlib use them in its own product but not redistribute them through its own API. Read those figures from the pages listed below — the `/api/` prefix for market data is disallowed in robots.txt. For bulk or programmatic market data, use CoinMarketCap directly.
- **Coinlib's own editorial content IS available as JSON.** Analysis articles, guides, newsroom posts, and coin FAQs are written in-house, so they are open — see "Content API" below.
- Coin page URLs use the pattern `/coin/{SYMBOL}/{Name-Slug}` with an uppercase symbol and the coin name with spaces replaced by hyphens, e.g. `/coin/BTC/Bitcoin` or `/coin/SHIB/Shiba-Inu`. The content API instead takes a lowercase slug, e.g. `bitcoin`, `shiba-inu`.
- Market data refreshes roughly every 5 minutes — re-fetching a page faster than that returns the same figures.
- All prices are in USD.
- Coinlib is an information site only: no trading, custody, or financial advice. See the disclaimer before citing figures as advice.

## MCP server

`https://mcp.coinlib.io` — remote, stateless Streamable HTTP, no API key or account. Also reachable at `https://coinlib.io/api/mcp`; same server.

Seven read-only tools: `search_coinlib` (start here — resolves a name or symbol to a coin_slug and page URL), `get_coin_faqs`, `list_coin_analysis`, `get_analysis_article`, `list_recent_analysis`, `get_guide`, `list_calculators`.

Same boundary as the Content API: the tools return Coinlib's own editorial content and coinlib.io links, never prices or market data.

## Content API

Coinlib's own editorial content, as JSON. Base URL `https://coinlib.io`. Anonymous `GET`, no API key, any origin. Full spec: [/openapi.json](https://coinlib.io/openapi.json) (OpenAPI 3.1).

Every response uses the envelope `{ "data": ..., "error": null, "meta": {...} }` — check `error` before reading `data`.

- `GET /api/v1/analysis` — all published analysis articles, newest first. `?limit=` (max 100), `?offset=`
- `GET /api/v1/analysis/{idOrSlug}` — one analysis article, full body
- `GET /api/v1/coins/{slug}/analysis` — analysis articles for one coin
- `GET /api/v1/coins/{slug}/faqs` — short, citable Q&A about one coin
- `GET /api/v1/newsroom/{category}/{slug}` — one guide or newsroom post. Categories: guides, technology, trading-software

Quote this content with attribution and a link back to the source page. Everything else under `/api/` — market data included — is disallowed in robots.txt and not for agent use.

## Key pages

- [Home / market overview](https://coinlib.io/): live prices table for top coins, global market cap, and highlights
- [All coins](https://coinlib.io/coins): full ranked coin list, paginated at /coins/{page}
- [Trending coins](https://coinlib.io/trending): coins with unusual activity right now
- [Gainers & losers](https://coinlib.io/gainers-losers): biggest 24h movers
- [Market weather](https://coinlib.io/market-weather): overall market sentiment snapshot
- [Exchanges](https://coinlib.io/exchanges): ranked crypto exchanges, detail at /exchanges/{slug}
- [Exchange fees comparison](https://coinlib.io/exchanges/fees): maker/taker fees for all tracked exchanges side by side
- [Compare coins](https://coinlib.io/compare): side-by-side comparison, e.g. /compare?a=bitcoin&b=ethereum (lowercase slugs)
- [Converter](https://coinlib.io/converter): convert between the top 100 coins and 14 fiat currencies
- [Analysis](https://coinlib.io/analysis): editorial coin analysis; per-coin posts live at /coin/{SYMBOL}/{Name}/analysis/{slug}
- [Guides](https://coinlib.io/guides): educational crypto guides
- [Calculators](https://coinlib.io/calculators): 11 trading calculators (margin, slippage, position-size, trading-fee, liquidation-price, spread, take-profit, stop-loss, options-profit, funding-rate, risk-reward) at /calculators/{slug}
- [Widgets](https://coinlib.io/widgets): embeddable price widgets for other websites
- [Sitemap](https://coinlib.io/sitemap.xml): full URL inventory (~1,800 URLs)

## Finding things

- To answer "what is the price of X", read the coin page at /coin/{SYMBOL}/{Name-Slug} (e.g. https://coinlib.io/coin/ETH/Ethereum). It carries current price, 1h/24h/7d/30d changes, market cap, volume, supply, FAQs, news, and analysis links in the HTML.
- For "what's moving today", read https://coinlib.io/trending or https://coinlib.io/gainers-losers.
- Coin analysis articles live under the coin page at /coin/{SYMBOL}/{Name-Slug}/analysis/{slug}; the full feed is at /analysis, or as JSON via `GET /api/v1/analysis`.
- Exchange details are at /exchanges/{slug} (e.g. https://coinlib.io/exchanges/binance).
- For a full URL inventory, use the sitemap at https://coinlib.io/sitemap.xml.

## Widgets

Embeddable price widgets for other websites are documented at https://coinlib.io/widgets (live price tables, single-coin tickers, charts, and a converter). The embed iframes themselves are not content pages — link users to /widgets to configure one.

## Policies

- [For AI agents](https://coinlib.io/for-agents): terms for automated use, endpoint list, and polling etiquette
- [About](https://coinlib.io/about)
- [Disclaimer](https://coinlib.io/disclaimer): market data is informational, not financial advice
- [Privacy policy](https://coinlib.io/privacy-policy)

## Optional

- [Authors](https://coinlib.io/authors): editorial team behind analysis and guides
- [OpenAPI spec](https://coinlib.io/openapi.json): machine-readable definition of the content API
- [MCP server](https://mcp.coinlib.io): Model Context Protocol endpoint for Claude and other MCP clients
- [Robots policy](https://coinlib.io/robots.txt): the content API endpoints are allowed; market-data and internal /api/ paths are not