Coinlib for AI Agents

AI agents and automated clients are welcome on Coinlib. Every page is readable without JavaScript, and the editorial content we write in-house is available as JSON with no API key and no account.

Market data: read the pages, not an API

Prices, market caps, volumes, rankings, exchange data, and conversion rates on Coinlib are licensed from CoinMarketCap and CoinGecko. Those licences let us use the data in our own product but not redistribute it through an API of our own, so we don't offer one — and the market-data routes are disallowed in robots.txt.

If you need live figures, read the HTML pages — coin pages at /coin/{SYMBOL}/{Name-Slug} carry price, changes, market cap, volume, and supply in the markup. For bulk or programmatic market data, go to CoinMarketCap directly — they license it, we don't sublicense it.

MCP server

Coinlib hosts a Model Context Protocol server, so you can add Coinlib to Claude or any MCP client and ask about coins in plain language. It's remote and stateless — no install, no API key, no account.

https://mcp.coinlib.io

Claude (web or desktop): Settings → Connectors → Add custom connector, and paste that URL.

Claude Code:

claude mcp add --transport http coinlib https://mcp.coinlib.io

Other clients that speak Streamable HTTP take the URL directly; stdio-only clients can bridge with npx mcp-remote https://mcp.coinlib.io. The endpoint is also reachable at https://coinlib.io/api/mcp — same server, either address works.

Seven tools, all read-only:

Tool	Does
search_coinlib	Find coins and analysis by name, symbol, or keyword. Start here.
get_coin_faqs	Coinlib's editorial Q&A about one coin.
list_coin_analysis	Analysis articles about one coin.
get_analysis_article	Full text of one analysis article.
list_recent_analysis	Coinlib's latest analysis across all coins.
get_guide	Full text of one guide or newsroom post.
list_calculators	Coinlib's trading calculators, with links.

The tools return Coinlib's editorial content and coinlib.io links. As above, none of them return prices or market data — ask for a live figure and the server hands back the coin page URL to open.

Content API

Base URL https://coinlib.io. All endpoints are GET, return JSON, need no authentication, and allow any origin. Full spec: /openapi.json (OpenAPI 3.1).

Endpoint	Returns
/api/v1/analysis	All published analysis articles, newest first. ?limit= (max 100), ?offset=
/api/v1/analysis/{idOrSlug}	One analysis article, including full body.
/api/v1/coins/{slug}/analysis	Analysis articles for one coin.
/api/v1/coins/{slug}/faqs	Short, citable Q&A about one coin.
/api/v1/newsroom/{category}/{slug}	One guide or newsroom post. Categories: guides, technology, trading-software

Every endpoint returns the same envelope. Check error before reading data.

{
  "data": [ ... ],
  "error": null,
  "meta": { "cached": true, "timestamp": 1756000000000 }
}

{slug} is the lowercase coin name with spaces replaced by hyphens — bitcoin, shiba-inu — the same slug that appears in the coin page URL.

Terms for automated use

These terms cover Coinlib's own editorial content: the analysis articles, guides, newsroom posts, and coin FAQs written by our team, i.e. everything the endpoints above return.

Reading, caching, quoting, and reasoning over that content with an automated client is permitted, including inside commercial products.
Quote it with attribution and a link to the source page on coinlib.io. Don't republish whole articles verbatim as your own.
Third-party market data reached through Coinlib — prices, market caps, volumes, rankings, exchange figures, and conversion rates — is not covered by these terms and is not ours to license onward. Your use of it is between you and its owner.
The endpoints listed above are the stable, supported surface. Other paths under /api/ are internal, are disallowed in robots.txt, and may change or disappear without notice.
Content is provided as-is with no uptime or accuracy guarantee, and is not financial advice. See the disclaimer.

Crawling etiquette

There is no hard rate limit, and we would rather keep it that way.

Use conditional requests. Every response carries an ETag. Send it back as If-None-Match and you get a 304 Not Modified with an empty body when nothing has changed.
Don't re-crawl faster than the content changes. Analysis and guides are published a few times a week, not a few times a minute.
Start from the map. /llms.txt describes the site in plain text, and /sitemap.xml lists roughly 1,800 URLs.

Who writes this

Analysis, guides, and coin FAQs are written by the Coinlib editorial team. If you are building on Coinlib and need something the API doesn't expose, or you hit a response that disagrees with the spec, tell us via the about page.