Runes

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

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

Why Use Our Runes API?

Comprehensive coverage of Runes transactions and trends.
Seamless integration for developers and analysts.
Reliable, fast, and designed for scalability.

PreviousBRC20

Last updated 19 days ago

Get Runes Market Information

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

GEThttps://api.ordnull.site/v3/x/runes/market_info

Authorization

Query parameters

Body

rune_namestring

rune_idstring

rune_numberinteger

Response

Successful response

Body

dataobject

block_heightinteger

Request

const response = await fetch('https://api.ordnull.site/v3/x/runes/market_info', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "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 Tickers

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.

GEThttps://api.ordnull.site/v3/runes/tickers

Authorization

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Current block height

Request

const response = await fetch('https://api.ordnull.site/v3/runes/tickers?sort_by=rune_id&order=asc&offset=1&count=1', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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-02-05T03:56:24.917Z",
      "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

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.

GEThttps://api.ordnull.site/v3/runes/ticker_info

Authorization

Query parameters

Response

Successful response

Body

dataobject

block_heightinteger

Current block height

Request

const response = await fetch('https://api.ordnull.site/v3/runes/ticker_info', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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-02-05T03:56:24.917Z",
    "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 Wallet Balances

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.

GEThttps://api.ordnull.site/v3/runes/wallet_balances

Authorization

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Current block height

Request

const response = await fetch('https://api.ordnull.site/v3/runes/wallet_balances', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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 Wallet Valid Outputs

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

GEThttps://api.ordnull.site/v3/runes/wallet_valid_outputs

Authorization

Query parameters

Response

Successful response

Body

dataarray of object

block_heightinteger

Request

const response = await fetch('https://api.ordnull.site/v3/runes/wallet_valid_outputs?sort_by=output&order=asc&offset=1&count=1', {
    method: 'GET',
    headers: {
      "x-api-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

{
  "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
}