THORChain

THORChain Reference Memos API

The Reference Memos API from THORChain — 3 operation(s) for reference memos.

GitHub OpenAPI

Operations 3

GET /thorchain/memo/{asset}/{reference} #
GET /thorchain/memo/{hash} #
GET /thorchain/memo/check/{asset}/{amount} #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thorchain/refs/heads/main/openapi/thorchain-reference-memos-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-reference-memos-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-reference-memos-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Thornode Auth Reference Memos API
  version: 3.19.1
  contact:
    email: devs@thorchain.org
  description: Thornode REST API.
servers:
- url: https://gateway.liquify.com/chain/thorchain_api
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Reference Memos
paths:
  /thorchain/memo/{asset}/{reference}:
    parameters:
    - $ref: '#/components/parameters/queryHeight'
    - $ref: '#/components/parameters/asset'
    - name: reference
      in: path
      description: the reference number to lookup
      required: true
      schema:
        type: string
        example: '20002'
    get:
      description: Returns the memoless transaction memo for the provided asset and reference number.
      operationId: referenceMemo
      tags:
      - Reference Memos
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferenceMemoResponse'
  /thorchain/memo/{hash}:
    parameters:
    - $ref: '#/components/parameters/queryHeight'
    - $ref: '#/components/parameters/hash'
    get:
      description: Returns the memoless transaction memo for the provided reference hash.
      operationId: referenceMemoByHash
      tags:
      - Reference Memos
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferenceMemoResponse'
  /thorchain/memo/check/{asset}/{amount}:
    parameters:
    - $ref: '#/components/parameters/queryHeight'
    - $ref: '#/components/parameters/asset'
    - name: amount
      in: path
      description: the transaction amount in base units to check
      required: true
      schema:
        type: string
        example: '20002'
    get:
      description: Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.
      operationId: referenceMemoCheck
      tags:
      - Reference Memos
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferenceMemoPreflightResponse'
components:
  schemas:
    ReferenceMemoResponse:
      type: object
      required:
      - asset
      - memo
      - reference
      - height
      - registration_hash
      - registered_by
      - used_by_txs
      properties:
        asset:
          type: string
          description: the asset for which this reference memo is valid
          example: BTC.BTC
        memo:
          type: string
          description: the original memo that was registered for memoless transactions
          example: =:ETH.ETH:0x1c7b17362c84287bd1184447e6dfeaf920c31bbe:1000:0:100
        reference:
          type: string
          description: the reference number used to identify this memo
          example: '20002'
        height:
          type: string
          description: the block height when this reference memo was registered
          example: '12345678'
        registration_hash:
          type: string
          description: the transaction hash where this reference memo was registered
          example: AF524818D42B63D25BBA0CCC4909F127CAA645C0F9CD07324F2824CC151A64C8
        registered_by:
          type: string
          description: the address that registered this reference memo
          example: thor1zupk5lmc84r2dh738a9g3zscavannjy3nzplwt
        used_by_txs:
          type: array
          description: list of transaction hashes that have used this reference memo
          items:
            type: string
          example:
          - AF524818D42B63D25BBA0CCC4909F127CAA645C0F9CD07324F2824CC151A64C8
          - BF524818D42B63D25BBA0CCC4909F127CAA645C0F9CD07324F2824CC151A64C9
    ReferenceMemoPreflightResponse:
      type: object
      required:
      - reference
      - available
      - can_register
      - expires_at
      - usage_count
      - max_use
      properties:
        reference:
          type: string
          description: the reference ID that would be generated from the amount
          example: '20002'
        available:
          type: boolean
          description: whether this reference is currently available (not registered or expired)
          example: true
        can_register:
          type: boolean
          description: whether a new registration can be made with this reference
          example: true
        expires_at:
          type: string
          description: block height when current registration expires (0 if available)
          example: '0'
        memo:
          type: string
          description: the currently registered memo (only present if not available)
          example: =:ETH.ETH:0x1c7b17362c84287bd1184447e6dfeaf920c31bbe
        usage_count:
          type: string
          description: the number of times this reference has been used
          example: '0'
        max_use:
          type: string
          description: the maximum number of times this reference can be used (0 = unlimited)
          example: '0'
  parameters:
    hash:
      name: hash
      in: path
      required: true
      schema:
        type: string
        example: CF524818D42B63D25BBA0CCC4909F127CAA645C0F9CD07324F2824CC151A64C7
    queryHeight:
      name: height
      in: query
      description: optional block height, defaults to current tip
      required: false
      schema:
        type: integer
        format: int64
        minimum: 0
    asset:
      name: asset
      in: path
      required: true
      schema:
        type: string
        example: BTC.BTC