> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomaestro.org/llms.txt
> Use this file to discover all available pages before exploring further.

> Get comprehensive registry of all Bitcoin Runes available for trading with metadata and market information.

# Rune Registry



## OpenAPI

````yaml bitcoin/market-price-api/openapi.json get /runes
openapi: 3.1.0
info:
  description: >-
    Maestro’s Market Price API delivers real-time, rollback-protected DEX
    trading activity alongside historical price mapping for both Bitcoin and
    Rune assets in USD. It combines deep network-level indexing with robust
    trade tracking, abstracting away the complexity of UTXO handling.

    #### Key Features:

    - **Mempool Awareness:** Provides insight into the latest trades from the
    mempool for the most dynamic price discovery.

    - **Multi-DEX Support:** Query data from supported decentralized
    exchanges—including Magic Eden and Dotswap—individually or in aggregate.

    - **Rollback Protection:** Ensures price accuracy by tracking chain
    reorganizations and updating data accordingly—no stale or orphaned block
    data.

    - **Dual-Pipeline Indexing:** Separately indexes UTXOs and trades for
    accuracy and real-time responsiveness.

    - **Real-Time DEX Price Feeds:** Continuously updated trade and price data,
    optimized for wallets, traders, and analytics platforms.

    - **Historical Price Mapping:** Access time-series price data (USD) for both
    Bitcoin and Rune assets, enabling historical analysis and charting.


    #### Key Benefits for Developers:

    - Track accurate, chain-verified prices without maintaining your own
    indexers.

    - Build DEX-integrated wallets and apps with reliable, real-time market
    signals.

    - Identify and act on price trends immediately, with confidence the data
    won’t be invalidated by reorgs.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.txt
  title: Bitcoin - Market Price API
  version: 0.1.0
servers:
  - description: Bitcoin Mainnet
    url: https://xbt-mainnet.gomaestro-api.org/v0/markets
  - description: Bitcoin Testnet (coming soon)
    url: https://xbt-testnet.gomaestro-api.org/v0/markets
security:
  - api-key: []
externalDocs:
  description: ''
  url: ''
paths:
  /runes:
    get:
      tags:
        - DEX
      summary: Rune Registry
      description: >-
        Returns metadata for Rune assets registered and etched into the Bitcoin
        blockchain. This includes human-readable name, symbol, divisibility
        (decimals), and genesis transaction. Filtering by `rune_id` narrows the
        query to a specific asset.
      operationId: mkt-dex
      parameters:
        - description: Bitcoin Rune ID
          example: '840000:28'
          in: query
          name: rune_id
          schema:
            default: '840000:28'
            maxLength: 16
            type: string
        - description: 'Limit number of Runes returned (min: 1, max: 50000)'
          example: 10000
          in: query
          name: limit
          schema:
            default: 5000
            maximum: 50000
            minimum: 1
            type: integer
        - description: Sort by descending (desc) or ascending (asc)
          example: desc
          in: query
          name: sort
          schema:
            default: desc
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.RuneRegistryList'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bitcoin_api.APIError'
          description: Bad Request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bitcoin_api.APIError'
          description: Server Error
components:
  schemas:
    models.RuneRegistryList:
      properties:
        data:
          items:
            $ref: '#/components/schemas/models.RuneRegistry'
          type: array
          uniqueItems: false
      type: object
    bitcoin_api.APIError:
      properties:
        error:
          description: Error returned from the API request
          example: Bad Request
          type: string
      type: object
    models.RuneRegistry:
      properties:
        divisibility:
          description: Number of decimal places supported
          example: 8
          type: integer
        etched_tx_hash:
          description: Transaction hash where the Rune was etched
          example: 2bebfc71ac93f02de19b28a8b438ed40413676f4c4c2609401a9a08ea508fd58
          type: string
        name:
          description: Human-readable name of the Rune
          example: DOGGOTOTHEMOON
          type: string
        rune_id:
          description: Symbol of the Rune asset trading pair (BTC-Rune ID)
          example: BTC-840000:28
          type: string
        spacer:
          description: Spacer value associated with the Rune
          example: 0
          type: integer
        symbol:
          description: Ticker symbol of the Rune
          example: DOGGO
          type: string
      type: object
  securitySchemes:
    api-key:
      description: Project API Key
      in: header
      name: api-key
      type: apiKey

````