canonical: https://jentic.com/apis/coinlib.io/coinlib

# Coinlib API

Jentic publishes the only available OpenAPI specification for Coinlib API, keeping it validated and agent-ready. Coinlib is a compact cryptocurrency data API exposing three endpoints: global market metrics, a paginated coin list with prices and market caps, and a per-coin lookup for detailed metadata. It is suitable for simple price displays, market overviews, and lightweight crypto data widgets.

## For AI agents

Look up current crypto prices, market caps, and global market metrics across thousands of coins via three simple Coinlib endpoints.

## Scope

Does not handle trading, wallets, or historical OHLC data - use for current crypto pricing, coin lookup, and global market metrics only.

## Capabilities

- Retrieve aggregated global crypto market data including total market cap and volume
- List coins with prices, market cap, supply, and 24-hour change in a paginated feed
- Look up a single coin by symbol with detailed pricing and metadata
- Quote crypto prices in any supported preferred currency
- Filter the coin list by page and order to surface top movers

## Use cases

### Crypto Market Overview Widget

Render a market overview widget showing global crypto market cap, total volume, and BTC dominance. The /global endpoint returns the headline numbers in one call, ideal for dashboards and homepages.

Example prompt: Call GET /global with pref=USD and return total market cap, total volume, and bitcoin dominance

### Coin Listing Table

Power a sortable table of cryptocurrencies with current price, market cap, supply, and 24-hour change. The /coinlist endpoint returns paginated rows that map directly to a UI table, suitable for explorers and education sites.

Example prompt: Call GET /coinlist with page=1 and return the top coins with price, market cap, and 24h change

### Single-Coin Detail Card

Build a coin detail card showing price, supply, market cap, and metadata for one specific coin. The /coin endpoint accepts a ticker symbol and returns the relevant fields in a single response. Useful for coin pages on educational and tracking sites.

Example prompt: Call GET /coin with symbol=BTC and pref=USD and return the price, supply, and 24h change

### AI Market Summariser via Jentic

Build an agent that produces brief crypto market summaries using Coinlib through Jentic. The agent expresses an intent (give me a market overview, look up a coin); Jentic resolves the right endpoint and executes the call with stored credentials. Cost-effective for chat assistants that need a one-line market summary.

Example prompt: Through Jentic, fetch global market data and the top three coins by market cap and produce a short summary

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/global` | Get aggregated global crypto market data |
| GET | `/coinlist` | List coins with prices and market caps (paginated) |
| GET | `/coin` | Look up a single coin by symbol |

## Key resources

- **Global** — Aggregated global crypto market metrics
- **Coin List** — Paginated list of coins with prices and market caps
- **Coin** — Single-coin lookup by ticker symbol

## Why Jentic

- **Setup:** Wiring Coinlib by hand means passing its key query parameter on every request to the coinlib.io host and handling its global, coin list, and coin lookup endpoints yourself. Through Jentic you install once, import Coinlib from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Coinlib serves read-only pricing and market metrics, so you scope by choosing the operations the agent may call: limit it to what it needs, such as reading a coin price or the global market overview, and other calls are not included unless you add them.
- **Credential handling:** Your Coinlib API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get a crypto market overview' or 'look up a coin price', and Jentic returns the matching Coinlib operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **CoinGecko API** — Far broader endpoint surface with detailed coin, exchange, and DeFi data
- **CoinCap API** — Free crypto data with history and per-asset market endpoints
- **CoinMarketCap API** — Industry-standard rankings and market cap data

## FAQ

### Why is there no official OpenAPI spec for Coinlib API?

Coinlib publishes textual API documentation but not a machine-readable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Coinlib API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Coinlib API use?

Coinlib uses an API key passed as the key query parameter on every request. Through Jentic, the key is stored in the encrypted vault and the agent receives a scoped execution token rather than the raw key value.

### Can I list cryptocurrencies with prices and market caps using Coinlib?

Yes. GET /coinlist returns a paginated list of coins with current price, market cap, circulating supply, and 24-hour change. Use the page query parameter to walk through results and the pref parameter to choose a quote currency.

### What are the rate limits for the Coinlib API?

Coinlib enforces per-key rate limits that vary by plan. The OpenAPI spec does not declare exact thresholds; consult your Coinlib account dashboard for current limits attached to your key.

### How do I look up a single coin's price through Jentic?

Install the SDK with pip install jentic, search Jentic for look up a single cryptocurrency price, load the schema for GET /coin, and execute with the symbol (for example BTC) and pref currency (for example USD).

### Does Coinlib expose global market metrics?

Yes. GET /global returns total crypto market capitalisation, total volume, and dominance percentages quoted in the preferred currency you supply, suitable for top-of-page market summaries.

### Can I limit what my agent is allowed to do with the Coinlib API?

Yes. Because you run Jentic One yourself, your own rules decide which Coinlib operations your agent may call, and it can only reach the ones you approve. Coinlib is read-only pricing and market data, so you can grant just the global market overview (GET /global) and leave the coin listing (GET /coinlist) and single-coin lookup (GET /coin) out, or allow only a coin price lookup, depending on what the agent needs. Any operation you do not include stays unavailable to the agent, and your stored API key is injected at execution time rather than exposed to it.