Cryptokeyhole

CryptoKeyhole API

On-chain and market analytics for Bitcoin, Ethereum and a growing list of coins, calculated from CryptoKeyhole's own nodes and collectors: every chart's…

Finance & banking#cryptocurrency

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

On-chain and market analytics for Bitcoin, Ethereum and a growing list of coins, calculated from CryptoKeyhole's own nodes and collectors: every chart's history as exact values, the metric catalogue, the Fear & Greed Index, perpetual futures screens and an MCP server for AI assistants.

Without a key you read the Free view: the Free charts at daily, weekly, monthly and yearly resolution with full history, plus the free tools' endpoints. A chart above your plan answers a fixed historical sample or a plan lock, never a current reading. With an API key from your account page (Plus and higher plans) you read what your plan includes: Plus adds hourly data, the Plus charts and downloads; Pro adds ten-minute data, every premium chart and full-history downloads; API & Team adds commercial use and unmetered calls. Keys are read-only and go in the Authorization header. Each client (key or address) may make 240 requests a minute; Plus includes 1,000 API calls a day and Pro 100,000 a month.

Free charts and free API data are licensed CC BY 4.0 (credit CryptoKeyhole with a link); their answers, JSON and CSV, carry a Link header with rel="license". Paid-plan data, the samples of paid charts and raw exchange or other third-party data are not covered and carry no such header.

Times are UTC Unix seconds; a range's start is included and its end is not. Values are exact decimal strings (null where there is no observation, never zero), each with its finality: final, provisional, or partial for the open period, which is updated hourly until it closes.

Endpoints 36

Charts

  • GETAssets/assetsThe public assets, Bitcoin first. Every other asset's chart ids start with its prefix (for example eth.).
  • GETMetric catalogue/catalogEvery chart of one asset with its id, name, unit, description, method, intervals, coverage and status. A planned chart that has not published carries status…
  • GETChart series/series?metric=eth.PriceUSDOne chart's observations, one point per period, and for charts with several lines their components. Free charts at 24h, 1w, 1M and 1Y need no key. A chart or…
  • GETSaved formula as a series/formula?id=stringA saved formula read like a chart. Anyone can read a formula by the share id of its public link; with your key you can also read your own saved formulas by…
  • GETChart download (Plus and higher)/export?metric=eth.PriceUSDThe chart pages' CSV or JSON download of one chart, with every provenance column, the source, licence and attribution of each series. Included with Plus and…
  • GETSQL over every chart's daily values/sql?q=SELECT a.asset, l.value FROM assets a JOIN latest l ON l.metric = a.price ORDER BY l.value DESCOne read-only statement (SELECT, or WITH ... SELECT; SQLite's dialect) over every public chart's daily values: tables series (asset, metric, chart, component,…
  • POSTSQL over every chart's daily values (long queries)/sqlAs GET /sql, with the statement in a JSON body. A signed-in browser session sends its X-CSRF-Token.
  • GETSQL tables, columns and examples/sql/schemaThe tables and views of the SQL database with their columns, the finality words, example queries and when the data was read. No key needed.
  • GETOne metric for every coin/bulk/metric?metric=PriceUSDOne chart for every coin that publishes it, in one call: each coin's <prefix>.<name> chart (Bitcoin's ckh.<name>) with its components, as daily values with…
  • GETEvery venue's funding and open interest for a coin/bulk/venues?asset=BTCA coin's perpetual funding rate (%, the venue's settled rate averaged over the day, as an 8-hour rate) and open interest (USD, at the day's close) on every…
  • GETThe nightly files/bulk/filesThe latest nightly files the plan includes: one gzip CSV per coin and the series list (Pro and API & Team) and the whole SQLite database (API & Team), each…
  • GETOne nightly file (a signed link)/bulk/file/:name?e=0&s=stringA file from GET /bulk/files, by the link it signed (e and s); no key needed. Byte ranges are supported for resumed downloads.
  • GETFirst-published values/vintages?metric=eth.ExchangeNetflowEach period's first published value, the reading a backtest would have seen at the time, or with asOf each period's value as it stood then. Every point…
  • GETThe charts with first-published values/vintages/chartsThe recorded charts and intervals, and since when each has been recorded. No key needed.
  • GETData webhooks and destinations/data-webhooksThe account's data webhooks (a chart's new values, or a screen's changes, pushed to one of its webhooks) and its webhook destinations. Pro and API & Team.
  • POSTAdd a data webhook/data-webhooksA chart ({destinationId, metric, interval}) or a screen ({destinationId, screen: {where}, interval}; the screener's conditions). Each new value is sent once…
  • POSTDelete a data webhook/data-webhooks/delete

Indices

  • GETFear & Greed Index/fear-and-greedThe crypto market's Fear & Greed Index, or one coin's: the latest reading (0 to 100 and exact), its band, the time it is as of and whether its UTC day is…
  • GETFear & Greed Index of every coin/fear-and-greed/coinsToday's reading of the market's index and of every coin with its own. Free and keyless (CORS).
  • GETLeverage gauge/leverageHow stretched leverage is in a coin, 0 to 100, hourly: open interest against market cap, funding, the futures basis, the long/short account ratio,…

Markets

  • GETPerpetual futures screener/perpsOne row per coin across the venues we collect, at the hour. Free (no key): the coins with the highest 24-hour volume, without open-interest, funding,…
  • GETCharts the asset screener reads/screener/fieldsEvery directory slot the asset screener can screen: its id (for where, cols and sort), name, directory path, how many coins have a chart in it and on which…
  • GETAsset screener/screener/assetsEvery coin screened by the latest readings of its own charts, matched by their place in the directory. where: all(...) or any(...) of conditions slot:measure…
  • GETFunding carry scanner/carryFunding-rate carry pairs across venues, after fees. Free (no key): the pairs with the highest 24-hour volume, without carry readings. Plus: every pair with…
  • GETOne carry pair (Plus and higher)/carry/pair?id=stringOne pair's costs, persistence, backtest and daily settled carry.
  • GETOne contract's snapshots (Pro and higher)/perps/history?contract=string
  • GETOne pair's legs and spread (Pro and higher)/carry/history?pair=string
  • GETOne contract's settled funding (Pro and higher)/carry/funding?contract=string
  • GETThe latest sharp price move of a coin, explained/moves/latestThe latest sharp move (a fall or rise within 15 minutes, 1 hour or 4 hours of at least four times the coin's own recent volatility, and at least 1%, 1.5% or…
  • GETThe archive of sharp price moves/movesEvery sharp move of a coin (or ALL) detected between from and to (Unix seconds), newest first, with its card, what our data saw, the base rates and what…

Tools

  • GETDaily closes/tools/closes?asset=BTCOne coin's daily USD closes from its first day, as its free price chart shows them: a (the coin), n (days), t0 (the first day, UTC seconds), v (one close or…

Platform

  • GETPlatform status/statusEach data source's processed frontier and freshness, as the site reports them.
  • POSTMCP server for AI assistants/mcpA Model Context Protocol server (JSON-RPC 2.0 over Streamable HTTP): initialize, tools/list and tools/call, with tools to list assets, find charts and read…
  • GETAPI usage and call packs/billing/usageCalls made with the account's keys today and this month (UTC), the plan's allowance for each and when it resets, calls left in API call packs and when the…
  • GETLive stream (server-sent events)/live/streamPrices (every 0.5 s while they move) and new blocks for everyone. With a Pro or API & Team key, also the data channels: trades ($100K+), liquidations ($10K+),…
  • GETLive stream channels/live/channelsThe channels of GET /live/stream with what each sends and its minimum size. No key needed.

API details

Base URL
https://cryptokeyhole.com/api/v1
Authentication
A bearer token in the Authorization header
Operations
36 operations on 34 pathsGET 32POST 4
Main resources
Charts 17Markets 10Platform 5Indices 3Tools 1
Response formats
application/json text/csv application/gzip text/event-stream
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the CryptoKeyhole API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the CryptoKeyhole API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Assets” (GET /assets), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the CryptoKeyhole API?

On-chain and market analytics for Bitcoin, Ethereum and a growing list of coins, calculated from CryptoKeyhole's own nodes and collectors: every chart's… It is listed under Finance & banking and has 36 endpoints.

Who publishes the CryptoKeyhole API?

It is listed from Cryptokeyhole's public API description (an OpenAPI document), not published by Cryptokeyhole on Swastik Codes. Anyone who controls cryptokeyhole.com can claim the profile by adding a DNS TXT record.

What is the base URL of the CryptoKeyhole API?

Requests go to https://cryptokeyhole.com/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the CryptoKeyhole API?

With A bearer token in the Authorization header.

How many endpoints does the CryptoKeyhole API have?

36 operations on 34 paths (32 GET, 4 POST). The largest groups are Charts, Markets, Platform, Indices.

Is forking the CryptoKeyhole API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.