THORChain

THORChain Holders API

The Holders API from THORChain — 1 operation(s) for holders.

GitHub OpenAPI

Operations 1

GET /v2/holders Current top holders for an asset #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thorchain/refs/heads/main/openapi/thorchain-holders-api-openapi.yml

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/thorchain:thorchain-holders-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 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.

GitHub Google LinkedIn

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

OpenAPI Specification

thorchain-holders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: devs@thorchain.org
  description: The Midgard Public API queries THORChain and any chains linked via the Bifröst and prepares information about the network to be readily available for public users. The API parses transaction event data from THORChain and stores them in a time-series database to make time-dependent queries easy. Midgard does not hold critical information. To interact with THORChain protocol, users should query THORNode directly.
  title: Midgard Public Holders API
  version: 2.34.2
servers:
- url: https://gateway.liquify.com/chain/thorchain_midgard
tags:
- name: Holders
paths:
  /v2/holders:
    get:
      description: 'Returns all coin amounts of the given asset ordered by their amounts in descending order.


        This endpoint is enabled only if the midgard startup config allows it.'
      operationId: GetHolders
      parameters:
      - description: Asset to get the top holders for.
        example: THOR.RUNE
        in: query
        name: asset
        schema:
          format: string
          type: string
      - description: Number of top holders to return, default is 100, maximum is 1000.
        example: 150
        in: query
        name: limit
        schema:
          format: int64
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/HolderResponse'
      summary: Current top holders for an asset
      tags:
      - Holders
components:
  responses:
    HolderResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Holders'
      description: object containing balance details for a given address
  schemas:
    Holder:
      properties:
        address:
          description: address of the holder
          example: thor102y0m3uptg0vvudeyh00r2fnz70wq7d8y7mu2g
          type: string
        coins:
          $ref: '#/components/schemas/Coins'
      required:
      - address
      - coins
      type: object
    Coins:
      items:
        $ref: '#/components/schemas/Coin'
      type: array
    Coin:
      description: Represents a digital currency amount
      properties:
        amount:
          description: Int64(e8), asset Amount.
          type: string
        asset:
          description: Asset in CHAIN.SYMBOL format
          type: string
      required:
      - asset
      - amount
      type: object
    Holders:
      items:
        $ref: '#/components/schemas/Holder'
      type: array