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.
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.
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
Sort order
Starting offset for pagination
Number of results to return
Filter by minting status:
- not_complete: only tickers with mintable = true
- completed: only tickers with mintable = false
- unset: all tickers
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-07-31T04:43:12.400Z",
"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
}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.
Non-Spaced name of Rune
Rune ID
Rune Number
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-07-31T04:43:12.400Z",
"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
}Returns market information about a specific runes ticker. One of rune_name, rune_id, or rune_number must be provided.
Non-Spaced name of Rune
Rune ID
Rune Number
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
}Returns unspent output information of a given wallet. Note: One of 'address' or 'pkscript' must be specified.
Bitcoin wallet address
Bitcoin script_pub_key
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
}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.
Bitcoin wallet address
Bitcoin script_pub_key
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
}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.
Bitcoin wallet address
Bitcoin script_pub_key
Non-Spaced name of Rune
Rune ID
Rune Number
Field to sort by (currently only timestamp is supported)
Sort order
Starting offset for pagination
Number of results to return
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-07-31T04:43:12.400Z",
"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.
Last updated