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.

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

ApiKeyAuth

x-api-KeystringRequired

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

200

Successful response

application/json

429

Rate limit exceeded

application/json

get

/runes/tickers

HTTPcURLJavaScriptPython

GET /v3/runes/tickers?sort_by=rune_id&order=asc&offset=1&count=1 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": "2026-01-22T18:45:52.351Z",
      "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

ApiKeyAuth

x-api-KeystringRequired

Query parameters

rune_namestringOptional

Non-Spaced name of Rune

rune_idstringOptional

Rune ID

rune_numberintegerOptional

Rune Number

Responses

200

Successful response

application/json

429

Rate limit exceeded

application/json

get

/runes/ticker_info

HTTPcURLJavaScriptPython

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": "2026-01-22T18:45:52.351Z",
    "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 Market Information

get

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

Authorizations

ApiKeyAuth

x-api-KeystringRequired

Query parameters

rune_namestringOptional

Non-Spaced name of Rune

rune_idstringOptional

Rune ID

rune_numberintegerOptional

Rune Number

Body

application/json

anyOptional

or

anyOptional

or

anyOptional

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/x/runes/market_info

HTTPcURLJavaScriptPython

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 Valid Outputs

get

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

Authorizations

ApiKeyAuth

x-api-KeystringRequired

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

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/runes/wallet_valid_outputs

HTTPcURLJavaScriptPython

GET /v3/runes/wallet_valid_outputs?sort_by=output&order=asc&offset=1&count=1 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 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

ApiKeyAuth

x-api-KeystringRequired

Query parameters

addressstringOptional

Bitcoin wallet address

pkscriptstringOptional

Bitcoin script_pub_key

Responses

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/runes/wallet_balances

HTTPcURLJavaScriptPython

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

ApiKeyAuth

x-api-KeystringRequired

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

200

Successful response

application/json

403

Invalid API Key

application/json

429

Rate limit exceeded

application/json

get

/runes/wallet_activity

HTTPcURLJavaScriptPython

GET /v3/runes/wallet_activity?sort_by=ts&order=asc&offset=1&count=1 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": "2026-01-22T18:45:52.351Z",
      "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
}

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.