CryptoKeyhole Markets API

Perpetual futures screener and funding carry

GitHub OpenAPI

Operations 10

GET /perps Perpetual futures screener #
GET /screener/fields Charts the asset screener reads #
GET /screener/assets Asset screener #
GET /carry Funding carry scanner #
GET /carry/pair One carry pair (Plus and higher) #
GET /perps/history One contract's snapshots (Pro and higher) #
GET /carry/history One pair's legs and spread (Pro and higher) #
GET /carry/funding One contract's settled funding (Pro and higher) #
GET /moves/latest The latest sharp price move of a coin, explained #
GET /moves The archive of sharp price moves #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cryptokeyhole:cryptokeyhole-markets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cryptokeyhole-markets-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cryptokeyhole Markets API
  version: 1.0.0
  contact:
    name: CryptoKeyhole
    url: https://cryptokeyhole.com/data-access/
  license:
    name: CC BY 4.0 (free data; paid-plan data under the terms of service)
    url: https://cryptokeyhole.com/methodology/#licence-title
  termsOfService: https://cryptokeyhole.com/terms/
  x-logo:
    url: https://cryptokeyhole.com/favicon.svg
  description: 'Operations tagged Markets across 2 of this provider''s published API definitions: cryptokeyhole-openapi.json, cryptokeyhole-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://cryptokeyhole.com/api/v1
tags:
- name: Markets
  description: Perpetual futures screener and funding carry
paths:
  /perps:
    get:
      tags:
      - Markets
      operationId: getPerpsScreener
      summary: Perpetual futures screener
      description: 'One 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, liquidation or long/short values. Plus: every coin and contract with those values, and CSV. Pro: the five-minute view.'
      security:
      - {}
      - bearerAuth: []
      parameters:
      - name: view
        in: query
        schema:
          type: string
          enum:
          - 1h
          - 5m
          default: 1h
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: The screener
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          $ref: '#/components/responses/PlanRequired'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /screener/fields:
    get:
      tags:
      - Markets
      operationId: getScreenerFields
      summary: Charts the asset screener reads
      description: 'Every 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 plans, and its units.'
      responses:
        '200':
          description: The slots
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /screener/assets:
    get:
      tags:
      - Markets
      operationId: getAssetScreen
      summary: Asset screener
      description: 'Every 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 op number, one nested group deep, at most 12; measure v (the reading), p1, p7, p30, p90 or p365 (the change in percent over that many days), d1 to d365 (the same change in the chart''s unit), z (the four-year z-score) or q (the four-year percentile); op or >=. cols: up to 10 slot:measure columns (sp: the shape of the last 90 closed days). Slots come from /screener/fields. A cell above the requester''s plan carries only its lock, and a condition on it never matches. Free (no key): the first 10 coins at the daily close. Plus: every coin, the latest hour and CSV. Pro: ten-minute readings and API keys.'
      security:
      - {}
      - bearerAuth: []
      parameters:
      - name: where
        in: query
        schema:
          type: string
        example: all(market.Mvrv:v<1,derivatives.FuturesFundingRatePerpetual:v<0)
      - name: cols
        in: query
        schema:
          type: string
        example: market.PriceUsdClose:v,market.PriceUsdClose:p30,market.Mvrv:v
      - name: sort
        in: query
        description: A slot:measure column, or asset for the ticker.
        schema:
          type: string
      - name: dir
        in: query
        schema:
          type: string
          enum:
          - desc
          - asc
          default: desc
      - name: reading
        in: query
        schema:
          type: string
          enum:
          - day
          - hour
          - tenmin
          default: day
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: The screen
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PlanRequired'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /carry:
    get:
      tags:
      - Markets
      operationId: getCarryScanner
      summary: Funding carry scanner
      description: 'Funding-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 net APR, costs, persistence and the backtest, and CSV. Pro: the five-minute view.'
      security:
      - {}
      - bearerAuth: []
      parameters:
      - name: view
        in: query
        schema:
          type: string
          enum:
          - 1h
          - 5m
          default: 1h
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: The carry pairs
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          $ref: '#/components/responses/PlanRequired'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /carry/pair:
    get:
      tags:
      - Markets
      operationId: getCarryPair
      summary: One carry pair (Plus and higher)
      description: One pair's costs, persistence, backtest and daily settled carry.
      security:
      - bearerAuth: []
      parameters:
      - name: id
        in: query
        required: true
        description: A pair id from /carry.
        schema:
          type: string
      responses:
        '200':
          description: The pair
          content:
            application/json:
              schema:
                type: object
        '402':
          $ref: '#/components/responses/PlanRequired'
        '404':
          $ref: '#/components/responses/NotFound'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /perps/history:
    get:
      tags:
      - Markets
      operationId: getPerpsHistory
      summary: One contract's snapshots (Pro and higher)
      security:
      - bearerAuth: []
      parameters:
      - name: contract
        in: query
        required: true
        description: A contract id from /perps.
        schema:
          type: string
      - name: interval
        in: query
        schema:
          type: string
          enum:
          - 5m
          - 1h
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
      responses:
        '200':
          description: The snapshots
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          $ref: '#/components/responses/PlanRequired'
        '404':
          $ref: '#/components/responses/NotFound'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /carry/history:
    get:
      tags:
      - Markets
      operationId: getCarryHistory
      summary: One pair's legs and spread (Pro and higher)
      security:
      - bearerAuth: []
      parameters:
      - name: pair
        in: query
        required: true
        description: A pair id from /carry.
        schema:
          type: string
      - name: interval
        in: query
        schema:
          type: string
          enum:
          - 5m
          - 1h
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
      responses:
        '200':
          description: The history
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          $ref: '#/components/responses/PlanRequired'
        '404':
          $ref: '#/components/responses/NotFound'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /carry/funding:
    get:
      tags:
      - Markets
      operationId: getSettledFunding
      summary: One contract's settled funding (Pro and higher)
      security:
      - bearerAuth: []
      parameters:
      - name: contract
        in: query
        required: true
        description: A contract id from /perps.
        schema:
          type: string
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - name: format
        in: query
        schema:
          type: string
          enum:
          - json
          - csv
      responses:
        '200':
          description: The settled funding
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          $ref: '#/components/responses/PlanRequired'
        '404':
          $ref: '#/components/responses/NotFound'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /moves/latest:
    get:
      tags:
      - Markets
      operationId: getLatestMove
      summary: The latest sharp price move of a coin, explained
      description: 'The 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 2.5%), found every minute, with what our own data saw during it and a card in plain English. Free (no key): BTC and ETH, built only from readings the free pages show (liquidations by side, open interest and funding, options expiry, ETF flows, transfers of $100M or more, dormant-coin moves of 1,000 BTC or more); the other parts are named in `locked`. Plus: every coin, venue detail, taker flow, the Coinbase premium, Hyperliquid large accounts, hourly exchange flows from our nodes and the base rates (what followed similar moves an hour and a day later). Sizes are exact fractions.'
      security:
      - {}
      - bearerAuth: []
      parameters:
      - name: asset
        in: query
        schema:
          type: string
          default: BTC
        description: A coin code (BTC, ETH, SOL, ...) or ALL.
      - name: direction
        in: query
        schema:
          type: string
          enum:
          - down
          - up
      responses:
        '200':
          description: The latest move of each coin asked for
          content:
            application/json:
              schema:
                type: object
        '402':
          $ref: '#/components/responses/PlanRequired'
    servers:
    - url: https://cryptokeyhole.com/api/v1
  /moves:
    get:
      tags:
      - Markets
      operationId: listMoves
      summary: The archive of sharp price moves
      description: 'Every 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 followed it an hour and a day later. Coverage: five-minute prices from 2020 for the longest histories, one-minute prices since mid-October 2026. Plus.'
      security:
      - bearerAuth: []
      - {}
      parameters:
      - name: asset
        in: query
        schema:
          type: string
          default: BTC
        description: A coin code (BTC, ETH, SOL, ...) or ALL.
      - name: from
        in: query
        schema:
          type: integer
      - name: to
        in: query
        schema:
          type: integer
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 200
      responses:
        '200':
          description: The moves
          content:
            application/json:
              schema:
                type: object
        '402':
          $ref: '#/components/responses/PlanRequired'
    servers:
    - url: https://cryptokeyhole.com/api/v1
components:
  parameters:
    end:
      name: end
      in: query
      description: UTC Unix seconds, not included. Without it the data runs to the latest value.
      schema:
        type: integer
    start:
      name: start
      in: query
      description: UTC Unix seconds, included. Without it the chart's default window applies.
      schema:
        type: integer
  responses:
    BadRequest:
      description: The request's parameters are invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Unknown chart, asset, id or API route
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PlanRequired:
      description: Included with a higher plan; locked names it
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Locked:
      type: object
      description: What a higher plan would include.
      properties:
        feature:
          type: string
          example: interval
        requiredPlan:
          type: string
          enum:
          - plus
          - pro
          - team
        requiredPlanName:
          type: string
          example: Plus
        currentPlan:
          type: string
          example: free
        currentPlanName:
          type: string
          example: Free
        upgradePath:
          type: string
          example: /pricing/
        allowedIntervals:
          type: array
          items:
            type: string
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
        locked:
          $ref: '#/components/schemas/Locked'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'An API key from your account page (Plus and higher plans): Authorization: Bearer <key>. Keys are read-only.'
externalDocs:
  description: API keys, plans, Google Sheets, Excel and Python
  url: https://cryptokeyhole.com/data-access/
x-refined-from:
- cryptokeyhole-openapi.json
- cryptokeyhole-openapi.json
x-provenance:
  method: harvested
  publisher: CryptoKeyhole
  source: https://cryptokeyhole.com/api/v1/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)