ChainDAQ
  • Welcome to ChainDAQ's API Documentation
  • Overview
  • Compatibility APIs
    • Wallets
    • Inscriptions
    • Collections
    • BRC20
    • Runes
    • Prices
Powered by GitBook
On this page
  1. Compatibility APIs

Runes

PreviousBRC20NextPrices

Last updated 1 month ago

Unlock the power of Runes with our API endpoints, designed to give you unparalleled access to:

  • Real-Time Data: Stay updated with the latest Runes activity.

  • Detailed Insights: Retrieve granular information about specific Runes.

  • Historical Trends: Analyze past performance to make data-driven decisions.

Whether you’re building analytical tools, trading strategies, or exploring the Runes ecosystem, our API delivers the data you need.

Want to Dive In? Request Your API Key

Why Use Our Runes API?

  • Comprehensive coverage of Runes transactions and trends.

  • Seamless integration for developers and analysts.

  • Reliable, fast, and designed for scalability.

Like what you see? Start accessing our Runes endpoints today! 👉 to request your API key and unlock the full potential of our API.

Fill out the form on our website

Get Runes Wallet Valid Outputs

get

Returns unspent output information of a given wallet. Note: One of 'address' or 'pkscript' must be specified.

Authorizations
Query parameters
addressstringOptional

Bitcoin wallet address

pkscriptstringOptional

Bitcoin script_pub_key

sort_bystring · enumRequiredPossible values:
orderstring · enumRequiredPossible values:
offsetintegerRequired
countinteger · min: 20 · max: 2000Required
Responses
get
GET /v3/runes/wallet_valid_outputs HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "pkscript": "text",
      "wallet_addr": "text",
      "output": "text",
      "rune_ids": [
        "text"
      ],
      "balances": [
        "text"
      ],
      "min_price": 1,
      "magiceden_price": 1,
      "unisat_price": 1,
      "rune_names": [
        "text"
      ],
      "spaced_rune_names": [
        "text"
      ],
      "decimals": [
        1
      ]
    }
  ],
  "block_height": 1
}

Get Runes Market Information

get

Returns market information about a specific runes ticker. One of rune_name, rune_id, or rune_number must be provided.

Authorizations
Query parameters
rune_namestringOptional

Non-Spaced name of Rune

rune_idstringOptional

Rune ID

rune_numberintegerOptional

Rune Number

Body
rune_namestringOptional
rune_idstringOptional
rune_numberintegerOptional
Responses
get
GET /v3/x/runes/market_info HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "rune_name": "text",
  "rune_id": "text",
  "rune_number": 1
}
{
  "data": {
    "marketcap": "text",
    "min_listed_unit_price_in_sats": "text",
    "min_listed_unit_price_unisat": "text",
    "min_listed_unit_price_magiceden": "text",
    "listed_supply": "text",
    "listed_supply_ratio": "text"
  },
  "block_height": 1
}

Get Runes Wallet Balances

get

Returns runes balance information about given bitcoin wallet address or pkscript. Note: One of address or pkscript must be specified. Note: avg_unit_price_in_sats and min_listed_unit_price_in_sats is scaled by decimals.

Authorizations
Query parameters
addressstringOptional

Bitcoin wallet address

pkscriptstringOptional

Bitcoin script_pub_key

Responses
get
GET /v3/runes/wallet_balances HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "pkscript": "text",
      "wallet_addr": "text",
      "rune_id": "text",
      "total_balance": "text",
      "rune_name": "text",
      "spaced_rune_name": "text",
      "decimals": 1,
      "avg_unit_price_in_sats": "text",
      "min_listed_unit_price_in_sats": "text",
      "min_listed_unit_price_magiceden": "text",
      "min_listed_unit_price_unisat": "text"
    }
  ],
  "block_height": 1
}

Get Runes Tickers

get

Returns information about runes tickers. Note: avg_unit_price_in_sats is scaled by decimals to make ordering more meaningful. Note: avg_unit_price_in_sats, min_listed_unit_price_in_sats, listed_supply, listed_supply_ratio, marketcap and total_sale_info are only available in PRO tier.

Authorizations
Query parameters
sort_bystring · enumRequired

Field to sort by. PRO tier fields include: avg_unit_price_in_sats, min_listed_unit_price_in_sats, min_listed_unit_price_unisat, listed_supply, listed_supply_ratio, marketcap, total_volume

Possible values:
orderstring · enumRequired

Sort order

Possible values:
offsetintegerRequired

Starting offset for pagination

countinteger · min: 20 · max: 200Required

Number of results to return

minting_statusstring · enumOptional

Filter by minting status:

  • not_complete: only tickers with mintable = true
  • completed: only tickers with mintable = false
  • unset: all tickers
Possible values:
Responses
get
GET /v3/runes/tickers HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "rune_id": "text",
      "rune_number": "text",
      "rune_name": "text",
      "spaced_rune_name": "text",
      "symbol": "text",
      "decimals": 1,
      "per_mint_amount": "text",
      "mint_cnt": "text",
      "mint_cnt_limit": "text",
      "premined_supply": "text",
      "total_minted_supply": "text",
      "burned_supply": "text",
      "circulating_supply": "text",
      "mint_progress": 1,
      "mint_start_block": 1,
      "mint_end_block": 1,
      "genesis_block": 1,
      "deploy_ts": "2025-04-26T12:48:03.209Z",
      "deploy_txid": "text",
      "auto_upgrade": true,
      "holder_count": 1,
      "event_count": 1,
      "mintable": true,
      "icon_inscr_id": "text",
      "icon_delegate_id": "text",
      "icon_content_url": "text",
      "icon_render_url": "text",
      "avg_unit_price_in_sats": 1,
      "min_listed_unit_price_in_sats": 1,
      "min_listed_unit_price_unisat": 1,
      "min_listed_unit_price_magieden": 1,
      "listed_supply": "text",
      "listed_supply_ratio": 1,
      "marketcap": 1,
      "total_sale_info": {
        "sale_count": 1,
        "sale_count_3h": 1,
        "sale_count_6h": 1,
        "sale_count_9h": 1,
        "sale_count_12h": 1,
        "sale_count_1d": 1,
        "sale_count_3d": 1,
        "sale_count_7d": 1,
        "sale_count_30d": 1,
        "sale_amount": 1,
        "vol_3h": 1,
        "vol_6h": 1,
        "vol_9h": 1,
        "vol_12h": 1,
        "vol_1d": 1,
        "vol_3d": 1,
        "vol_7d": 1,
        "vol_30d": 1,
        "vol_total": 1
      }
    }
  ],
  "block_height": 1
}

Get Runes Ticker Information

get

Returns information about given runes ticker. Note: One of rune_name, rune_id or rune_number must be specified. Note: avg_unit_price_in_sats, min_listed_unit_price_in_sats, listed_supply, listed_supply_ratio, marketcap and total_sale_info are only available in PRO tier.

Authorizations
Query parameters
rune_namestringOptional

Non-Spaced name of Rune

rune_idstringOptional

Rune ID

rune_numberintegerOptional

Rune Number

Responses
get
GET /v3/runes/ticker_info HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "rune_id": "text",
    "rune_number": "text",
    "rune_name": "text",
    "spaced_rune_name": "text",
    "symbol": "text",
    "decimals": 1,
    "per_mint_amount": "text",
    "mint_cnt": "text",
    "mint_cnt_limit": "text",
    "premined_supply": "text",
    "total_minted_supply": "text",
    "burned_supply": "text",
    "circulating_supply": "text",
    "mint_progress": 1,
    "mint_start_block": 1,
    "mint_end_block": 1,
    "genesis_block": 1,
    "deploy_ts": "2025-04-26T12:48:03.209Z",
    "deploy_txid": "text",
    "auto_upgrade": true,
    "holder_count": 1,
    "event_count": 1,
    "mintable": true,
    "icon_inscr_id": "text",
    "icon_delegate_id": "text",
    "icon_content_url": "text",
    "icon_render_url": "text",
    "avg_unit_price_in_sats": 1,
    "min_listed_unit_price_in_sats": 1,
    "min_listed_unit_price_unisat": 1,
    "min_listed_unit_price_magieden": 1,
    "listed_supply": "text",
    "listed_supply_ratio": 1,
    "marketcap": 1,
    "total_sale_info": {
      "sale_count": 1,
      "sale_count_3h": 1,
      "sale_count_6h": 1,
      "sale_count_9h": 1,
      "sale_count_12h": 1,
      "sale_count_1d": 1,
      "sale_count_3d": 1,
      "sale_count_7d": 1,
      "sale_count_30d": 1,
      "sale_amount": 1,
      "vol_3h": 1,
      "vol_6h": 1,
      "vol_9h": 1,
      "vol_12h": 1,
      "vol_1d": 1,
      "vol_3d": 1,
      "vol_7d": 1,
      "vol_30d": 1,
      "vol_total": 1
    }
  },
  "block_height": 1
}
  • GETGet Runes Tickers
  • GETGet Runes Ticker Information
  • GETGet Runes Market Information
  • GETGet Runes Wallet Valid Outputs
  • GETGet Runes Wallet Balances
  • GETGet Runes Wallet Activity

Get Runes Wallet Activity

get

Retrieves rune transaction activity for a specified wallet. When a wallet participates in a rune transaction, this endpoint returns all transaction activity, including inputs/outputs involving other wallets.

Note: You must provide either 'address' or 'pkscript' to identify the wallet.

Optional rune filtering is available. To see all wallet activity, leave rune_name, rune_id, and rune_number parameters empty. To filter for specific rune transactions, provide exactly one of these parameters to show only transactions where the specified wallet interacts with that particular rune.

Authorizations
Query parameters
addressstringOptional

Bitcoin wallet address

pkscriptstringOptional

Bitcoin script_pub_key

rune_namestringOptional

Non-Spaced name of Rune

rune_idstringOptional

Rune ID

rune_numberintegerOptional

Rune Number

sort_bystring · enumRequired

Field to sort by (currently only timestamp is supported)

Possible values:
orderstring · enumRequired

Sort order

Possible values:
offsetintegerRequired

Starting offset for pagination

countinteger · min: 20 · max: 2000Required

Number of results to return

Responses
get
GET /v3/runes/wallet_activity HTTP/1.1
Host: api.ordnull.site
x-api-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "event_type": "input",
      "txid": "text",
      "outpoint": "text",
      "pkscript": "text",
      "wallet_addr": "text",
      "rune_id": "text",
      "amount": "text",
      "block_height": 1,
      "block_timestamp": "2025-04-26T12:48:03.209Z",
      "rune_name": "text",
      "spaced_rune_name": "text",
      "decimals": 1,
      "sale_info": {
        "sale_price": 1,
        "sold_to_pkscript": "text",
        "sold_to_wallet_addr": "text",
        "marketplace": "text"
      },
      "icon_content_url": "text",
      "icon_render_url": "text"
    }
  ],
  "block_height": 1
}