CoinGecko Companies API

Public company cryptocurrency holdings data.

Operations 1

GET /companies/public_treasury/{coin_id} Get public company crypto holdings #

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/coingecko-companies-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

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

OpenAPI Specification

coingecko-companies-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: CoinGecko Crypto Market Data Companies API
  description: The CoinGecko Crypto Market Data API provides comprehensive and reliable cryptocurrency price and market data through RESTful JSON endpoints. It offers over 70 endpoints covering real-time and historical prices, trading volumes, market capitalization, OHLCV data, exchange information, NFT metrics, derivatives data, and public treasury holdings for over 18,000 coins. The Demo API plan provides free access with 30 calls per minute to a subset of 30 publicly accessible endpoints.
  version: 3.0.1
  contact:
    name: CoinGecko Support
    url: https://support.coingecko.com
  termsOfService: https://www.coingecko.com/en/terms
servers:
- url: https://api.coingecko.com/api/v3
  description: CoinGecko Demo API Server
security:
- demoApiKeyHeader: []
- demoApiKeyQuery: []
tags:
- name: Companies
  description: Public company cryptocurrency holdings data.
paths:
  /companies/public_treasury/{coin_id}:
    get:
      operationId: getCompaniesPublicTreasury
      summary: Get public company crypto holdings
      description: Get the list of public companies that hold bitcoin or ethereum in their treasury, including the amount held, total value, and percentage of total supply.
      tags:
      - Companies
      parameters:
      - name: coin_id
        in: path
        required: true
        description: The coin ID (bitcoin or ethereum)
        schema:
          type: string
          enum:
          - bitcoin
          - ethereum
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_holdings:
                    type: number
                    description: Total amount of crypto held by all companies
                  total_value_usd:
                    type: number
                    description: Total USD value of all holdings
                  market_cap_dominance:
                    type: number
                    description: Percentage of total market cap held
                  companies:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompanyHolding'
components:
  schemas:
    CompanyHolding:
      type: object
      properties:
        name:
          type: string
          description: Company name
        symbol:
          type: string
          description: Stock ticker symbol
        country:
          type: string
          description: Country of incorporation
        total_holdings:
          type: number
          description: Total cryptocurrency holdings
        total_entry_value_usd:
          type: number
          description: Total entry value in USD
        total_current_value_usd:
          type: number
          description: Total current value in USD
        percentage_of_total_supply:
          type: number
          description: Percentage of total cryptocurrency supply held
  securitySchemes:
    demoApiKeyHeader:
      type: apiKey
      in: header
      name: x-cg-demo-api-key
      description: CoinGecko Demo API key passed via request header. Obtain a free key from the CoinGecko developer dashboard.
    demoApiKeyQuery:
      type: apiKey
      in: query
      name: x_cg_demo_api_key
      description: CoinGecko Demo API key passed via query string parameter.
externalDocs:
  description: CoinGecko API Documentation
  url: https://docs.coingecko.com