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-thorname-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

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 Thorname API
  version: 2.34.2
servers:
- url: https://gateway.liquify.com/chain/thorchain_midgard
tags:
- name: Thorname
paths:
  /v2/thorname/lookup/{name}:
    get:
      description: Returns an array of chains and their addresses associated with the given THORName
      operationId: GetTHORNameDetail
      parameters:
      - description: a THORName
        example: thorchain
        in: path
        name: name
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/THORNameDetailsResponse'
      summary: THORName Details
      tags:
      - Thorname
  /v2/thorname/owner/{address}:
    get:
      description: 'Returns an array of THORNames owned by the address. The address is not necessarily an

        associated address for those thornames.'
      operationId: GetTHORNamesOwnerByAddress
      parameters:
      - description: Address which owns a THORName.
        example: thor102y0m3uptg0vvudeyh00r2fnz70wq7d8y7mu2g
        in: path
        name: address
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/ReverseTHORNameResponse'
      summary: THORName owner
      tags:
      - Thorname
  /v2/thorname/rlookup/{address}:
    get:
      description: Returns an array of THORNames associated with the given address
      operationId: GetTHORNamesByAddress
      parameters:
      - description: Address to match THORNames against.
        example: bnb1jxfh2g85q3v0tdq56fnevx6xcxtcnhtsmcu64m
        in: path
        name: address
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/ReverseTHORNameResponse'
      summary: Gives a list of THORNames by reverse lookup
      tags:
      - Thorname
components:
  schemas:
    THORNameDetails:
      properties:
        entries:
          description: List details of all chains and their addresses for a given THORName
          items:
            $ref: '#/components/schemas/THORNameEntry'
          type: array
        expire:
          description: Int64, THORChain block height in which THORName expires
          type: string
        owner:
          description: owner's THOR address
          example: thor102y0m3uptg0vvudeyh00r2fnz70wq7d8y7mu2g
          type: string
      required:
      - owner
      - expire
      - entries
      type: object
    ReverseTHORNames:
      items:
        description: THORName name
        example: myname
        type: string
      type: array
    THORNameEntry:
      properties:
        address:
          description: address on blockchain
          type: string
        chain:
          description: blockchain
          type: string
      required:
      - chain
      - address
      type: object
  responses:
    THORNameDetailsResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/THORNameDetails'
      description: object containing THORName data for a specific name
    ReverseTHORNameResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ReverseTHORNames'
      description: object containing a list of THORName names for a specific address