canonical: https://jentic.com/apis/bitculator.com/bitculator # Bitculator Data API The Bitculator Data API delivers cryptocurrency market data across coins, prices, exchanges, and derivatives. It serves live and historical prices, candle and market-cap history, exchange trust scores, per-coin technical indicators such as RSI and MACD, sentiment indices like Fear and Greed, and a derivatives liquidation feed. Beyond read-only data, it lets you cast sentiment votes, set price alarms, and register webhook endpoints that receive HMAC-signed events. Crypto-to-fiat conversion and a set of financial calculators round out the surface. ## For AI agents Query real-time and historical cryptocurrency market data: coin prices, candle history, exchange trust scores, technical indicators, sentiment indices, and liquidation feeds. Agents can also set price alarms and register webhook endpoints. ## Scope Does not handle order execution, trading, custody, or wallet transactions. Use for crypto market data, indicators, and sentiment only. ## Capabilities - Retrieve live and historical prices, candle history, and market caps for ranked crypto coins - Track top gainers, losers, trending coins, and recently added listings - Read exchange rankings, trust scores, and per-exchange tickers and trading pairs - Pull per-coin technical indicators such as RSI, MACD, SMA, and VWAP from dedicated endpoints - Query market sentiment indices including Fear and Greed, Bull/Bear, and Altseason - Monitor derivatives liquidation feeds and set price alarms with webhook delivery - Convert between crypto and fiat assets and run DCA, profit-loss, and staking calculators ## Use cases ### AI Agent Market Monitoring An AI agent connected through Jentic can pull live crypto prices, sentiment indices, and liquidation data on demand to answer market questions or trigger actions. The agent searches for the operation it needs, Bitculator returns the matching endpoint and input schema, and the agent calls it with a stored Bearer token. This lets a trading or research assistant stay current without a human copying numbers from a dashboard. Example prompt: Fetch the current Fear and Greed index and the top five gaining coins, then summarise overall market sentiment ### Technical Analysis Dashboards Build dashboards that chart momentum and volume indicators for any tracked coin. Bitculator exposes a dedicated endpoint per indicator (RSI, Stochastic RSI, MACD, SMA, CCI, OBV and VWAP among others), each returning a time series you can render directly. Pair the indicator endpoints with candle history to overlay signals on price. Example prompt: Retrieve the RSI and MACD time series for a coin and flag when RSI crosses above 70 ### Price Alarms and Webhooks Create price alarms that notify your systems when a coin crosses a threshold, delivered to a registered webhook endpoint with an HMAC-signed payload. Agents can list, create, and delete alarms, register and test webhook endpoints, and read the delivery log to confirm receipt. Example prompt: Create a price alarm for a coin and register a webhook endpoint to receive the alert ### Crypto-to-Fiat Conversion Convert between any two active crypto or fiat assets using current rates, and list the fiat currencies available as conversion legs. The conversion data backs calculators for dollar-cost averaging, profit and loss, compound interest, loans, and staking rewards. Example prompt: Convert 500 USD to Bitcoin and estimate the staking rewards over one year ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/prices` | List current coin prices | | GET | `/api/v1/coins/{slug}/history` | Candle history for a coin | | GET | `/api/v1/coins/gainers` | Top gaining coins | | GET | `/api/v1/sentiment/fear-greed` | Fear and Greed index | | GET | `/api/v1/coins/{slug}/indicators/rsi` | RSI for a coin | | POST | `/api/v1/alarms` | Create a price alarm | | POST | `/api/v1/webhooks` | Create a webhook endpoint | | GET | `/api/v1/exchanges` | List exchanges | ## Key resources - **Coins** — List, detail, movers, and history for ranked coins and tokens - **Exchanges** — Exchange rankings, trust scores, and per-exchange tickers - **Indicators** — Per-coin technical indicators, one endpoint per indicator - **Sentiment** — Market and per-coin sentiment indices - **Alarms and Webhooks** — Price alarms and webhook endpoints with delivery logs ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 68 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 67 / 100 - Developer Experience & Jentic Compatibility: 89 / 100 - AI-Readiness & Agent Experience: 51 / 100 - Agent Usability: 88 / 100 - Security: 60 / 100 - AI Discoverability: 75 / 100 - **View full report:** https://jentic.com/apis/bitculator.com/bitculator/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Bitculator Data API by hand means setting up Bearer token auth, keeping the key server-side, and handling pagination and webhook signature verification yourself. Through Jentic you install once, import Bitculator from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Bitculator's write operations (price alarms, webhook endpoints, and sentiment votes) are separate from its read-only market-data endpoints, so a rule can hold your agent to the reads it needs. You choose the operations it may call, so creating or deleting an alarm or webhook is not included unless you add it. - **Credential handling:** Your Bitculator Bearer token 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 the price of a coin' or 'read the Fear and Greed index', and Jentic returns the matching Bitculator operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **CoinGecko** — Free, broad crypto market data covering prices, coins, and exchanges. - **CoinMarketCap** — Market caps, prices, and rankings for a large coin universe. - **Coinpaprika** — Market data, tickers, and exchange information for crypto assets. - **Binance** — Exchange API for live order books and trade execution. ## FAQ ### What authentication does the Bitculator Data API use? The Bitculator Data API authenticates with a Bearer token per its OpenAPI spec: create a Data API key in the Bitculator developer console and send it in the Authorization header. Keys are meant to stay server-side. Through Jentic the token is stored once, encrypted, by your own Jentic One instance and injected when the agent calls, so it never enters the agent's prompt or logs. ### Can I get technical indicators like RSI and MACD with the Bitculator Data API? Yes. Bitculator exposes a dedicated endpoint for each indicator, including RSI, Stochastic RSI, MACD, SMA, CCI, MFI, Williams %R, OBV, ADX, VWAP, and Chaikin Money Flow, each returning a time series for a given coin. Pair them with the candle history endpoint to align indicators with price. ### Is there a Bitculator MCP server? You don't need an MCP server to give your agent the Bitculator Data API. Jentic connects it directly from the API Directory: import the API, store your Bearer token once, and your agent calls the endpoints it needs. That keeps your agent's context free of an extra server's tool definitions. ### Can I limit what my agent is allowed to do with the Bitculator Data API? Yes. Nearly all Bitculator operations are read-only market data; the write operations are casting a sentiment vote, creating or deleting price alarms, managing webhook endpoints, and submitting article feedback. You decide which of these your agent may call, so a research agent can be given the price, indicator, and sentiment reads while nothing that creates an alarm or webhook is in reach, and every call it makes is logged. ### What are the rate limits for the Bitculator Data API? The OpenAPI spec does not publish specific rate limits. Bitculator exposes a key usage and quota endpoint you can poll to track consumption, and documents its versioning and disclosure policies at bitculator.com. Check your developer console for the limits that apply to your key. ### How do I pull crypto prices with the Bitculator Data API through Jentic? Search Jentic for an intent like 'get crypto prices', and it returns the Bitculator price operation with its input schema so your agent can call it with a coin slug. Your stored Bearer token is injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.