> For the complete documentation index, see [llms.txt](https://ordnull.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ordnull.gitbook.io/api/compatibility-apis/runes.md).
# 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
> 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.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesTickerInfo":{"type":"object","properties":{"rune_id":{"type":"string","description":"Unique identifier for the rune"},"rune_number":{"type":"string","description":"Rune number"},"rune_name":{"type":"string","description":"Name of the rune without spaces"},"spaced_rune_name":{"type":"string","description":"Name of the rune with spaces"},"symbol":{"type":"string","description":"Rune symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"per_mint_amount":{"type":"string","description":"Amount per mint"},"mint_cnt":{"type":"string","description":"Current mint count"},"mint_cnt_limit":{"type":"string","description":"Maximum mint count"},"premined_supply":{"type":"string","description":"Pre-mined supply"},"total_minted_supply":{"type":"string","description":"Total minted supply"},"burned_supply":{"type":"string","description":"Amount of burned supply"},"circulating_supply":{"type":"string","description":"Current circulating supply"},"mint_progress":{"type":"number","description":"Minting progress percentage"},"mint_start_block":{"type":"integer","nullable":true,"description":"Block number when minting started"},"mint_end_block":{"type":"integer","nullable":true,"description":"Block number when minting ends"},"genesis_block":{"type":"integer","description":"Genesis block number"},"deploy_ts":{"type":"string","format":"date-time","description":"Deployment timestamp"},"deploy_txid":{"type":"string","description":"Deployment transaction ID"},"auto_upgrade":{"type":"boolean","description":"Whether auto upgrade is enabled"},"holder_count":{"type":"integer","description":"Number of holders"},"event_count":{"type":"integer","description":"Number of events"},"mintable":{"type":"boolean","description":"Whether the rune is mintable"},"icon_inscr_id":{"type":"string","nullable":true,"description":"Icon inscription ID"},"icon_delegate_id":{"type":"string","description":"Icon delegate ID"},"icon_content_url":{"type":"string","nullable":true,"description":"URL for icon content"},"icon_render_url":{"type":"string","nullable":true,"description":"URL for icon render"},"avg_unit_price_in_sats":{"type":"number","description":"Average unit price in satoshis (PRO tier only)"},"min_listed_unit_price_in_sats":{"type":"number","description":"Minimum listed unit price in satoshis (PRO tier only)"},"min_listed_unit_price_unisat":{"type":"number","description":"Minimum listed unit price on Unisat"},"min_listed_unit_price_magieden":{"type":"number","description":"Minimum listed unit price on Unisat"},"listed_supply":{"type":"string","description":"Amount of supply listed (PRO tier only)"},"listed_supply_ratio":{"type":"number","description":"Ratio of listed supply (PRO tier only)"},"marketcap":{"type":"integer","description":"Market capitalization (PRO tier only)"},"total_sale_info":{"$ref":"#/components/schemas/RunesTotalSaleInfo","description":"Detailed sale information (PRO tier only)"}}},"RunesTotalSaleInfo":{"type":"object","properties":{"sale_count":{"type":"integer","description":"Total number of sales"},"sale_count_3h":{"type":"integer","description":"Number of sales in last 3 hours"},"sale_count_6h":{"type":"integer","description":"Number of sales in last 6 hours"},"sale_count_9h":{"type":"integer","description":"Number of sales in last 9 hours"},"sale_count_12h":{"type":"integer","description":"Number of sales in last 12 hours"},"sale_count_1d":{"type":"integer","description":"Number of sales in last 24 hours"},"sale_count_3d":{"type":"integer","description":"Number of sales in last 3 days"},"sale_count_7d":{"type":"integer","description":"Number of sales in last 7 days"},"sale_count_30d":{"type":"integer","description":"Number of sales in last 30 days"},"sale_amount":{"type":"integer","description":"Total sale amount"},"vol_3h":{"type":"integer","description":"Volume in last 3 hours"},"vol_6h":{"type":"integer","description":"Volume in last 6 hours"},"vol_9h":{"type":"integer","description":"Volume in last 9 hours"},"vol_12h":{"type":"integer","description":"Volume in last 12 hours"},"vol_1d":{"type":"integer","description":"Volume in last 24 hours"},"vol_3d":{"type":"integer","description":"Volume in last 3 days"},"vol_7d":{"type":"integer","description":"Volume in last 7 days"},"vol_30d":{"type":"integer","description":"Volume in last 30 days"},"vol_total":{"type":"integer","description":"Total volume"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/runes/tickers":{"get":{"summary":"Get Runes Tickers","description":"Returns information about runes tickers.\nNote: avg_unit_price_in_sats is scaled by decimals to make ordering more meaningful.\nNote: 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.\n","parameters":[{"name":"sort_by","in":"query","required":true,"schema":{"type":"string","enum":["rune_id","rune_number","rune_name","mint_cnt","total_minted_supply","burned_supply","circulating_supply","mint_progress","deploy_ts","holder_count","event_count","avg_unit_price_in_sats","min_listed_unit_price_in_sats","min_listed_unit_price_unisat","min_listed_unit_price_magiceden","listed_supply","listed_supply_ratio","marketcap","total_volume"]},"description":"Field to sort by. PRO tier fields include:\navg_unit_price_in_sats, min_listed_unit_price_in_sats, min_listed_unit_price_unisat,\nlisted_supply, listed_supply_ratio, marketcap, total_volume\n"},{"name":"order","in":"query","required":true,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sort order"},{"name":"offset","in":"query","required":true,"schema":{"type":"integer","minimum":0},"description":"Starting offset for pagination"},{"name":"count","in":"query","required":true,"schema":{"type":"integer","minimum":20,"maximum":200},"description":"Number of results to return"},{"name":"minting_status","in":"query","required":false,"schema":{"type":"string","enum":["not_complete","completed"]},"description":"Filter by minting status:\n- not_complete: only tickers with mintable = true\n- completed: only tickers with mintable = false\n- unset: all tickers\n"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RunesTickerInfo"}},"block_height":{"type":"integer","description":"Current block height"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
## 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.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesTickerInfo":{"type":"object","properties":{"rune_id":{"type":"string","description":"Unique identifier for the rune"},"rune_number":{"type":"string","description":"Rune number"},"rune_name":{"type":"string","description":"Name of the rune without spaces"},"spaced_rune_name":{"type":"string","description":"Name of the rune with spaces"},"symbol":{"type":"string","description":"Rune symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"per_mint_amount":{"type":"string","description":"Amount per mint"},"mint_cnt":{"type":"string","description":"Current mint count"},"mint_cnt_limit":{"type":"string","description":"Maximum mint count"},"premined_supply":{"type":"string","description":"Pre-mined supply"},"total_minted_supply":{"type":"string","description":"Total minted supply"},"burned_supply":{"type":"string","description":"Amount of burned supply"},"circulating_supply":{"type":"string","description":"Current circulating supply"},"mint_progress":{"type":"number","description":"Minting progress percentage"},"mint_start_block":{"type":"integer","nullable":true,"description":"Block number when minting started"},"mint_end_block":{"type":"integer","nullable":true,"description":"Block number when minting ends"},"genesis_block":{"type":"integer","description":"Genesis block number"},"deploy_ts":{"type":"string","format":"date-time","description":"Deployment timestamp"},"deploy_txid":{"type":"string","description":"Deployment transaction ID"},"auto_upgrade":{"type":"boolean","description":"Whether auto upgrade is enabled"},"holder_count":{"type":"integer","description":"Number of holders"},"event_count":{"type":"integer","description":"Number of events"},"mintable":{"type":"boolean","description":"Whether the rune is mintable"},"icon_inscr_id":{"type":"string","nullable":true,"description":"Icon inscription ID"},"icon_delegate_id":{"type":"string","description":"Icon delegate ID"},"icon_content_url":{"type":"string","nullable":true,"description":"URL for icon content"},"icon_render_url":{"type":"string","nullable":true,"description":"URL for icon render"},"avg_unit_price_in_sats":{"type":"number","description":"Average unit price in satoshis (PRO tier only)"},"min_listed_unit_price_in_sats":{"type":"number","description":"Minimum listed unit price in satoshis (PRO tier only)"},"min_listed_unit_price_unisat":{"type":"number","description":"Minimum listed unit price on Unisat"},"min_listed_unit_price_magieden":{"type":"number","description":"Minimum listed unit price on Unisat"},"listed_supply":{"type":"string","description":"Amount of supply listed (PRO tier only)"},"listed_supply_ratio":{"type":"number","description":"Ratio of listed supply (PRO tier only)"},"marketcap":{"type":"integer","description":"Market capitalization (PRO tier only)"},"total_sale_info":{"$ref":"#/components/schemas/RunesTotalSaleInfo","description":"Detailed sale information (PRO tier only)"}}},"RunesTotalSaleInfo":{"type":"object","properties":{"sale_count":{"type":"integer","description":"Total number of sales"},"sale_count_3h":{"type":"integer","description":"Number of sales in last 3 hours"},"sale_count_6h":{"type":"integer","description":"Number of sales in last 6 hours"},"sale_count_9h":{"type":"integer","description":"Number of sales in last 9 hours"},"sale_count_12h":{"type":"integer","description":"Number of sales in last 12 hours"},"sale_count_1d":{"type":"integer","description":"Number of sales in last 24 hours"},"sale_count_3d":{"type":"integer","description":"Number of sales in last 3 days"},"sale_count_7d":{"type":"integer","description":"Number of sales in last 7 days"},"sale_count_30d":{"type":"integer","description":"Number of sales in last 30 days"},"sale_amount":{"type":"integer","description":"Total sale amount"},"vol_3h":{"type":"integer","description":"Volume in last 3 hours"},"vol_6h":{"type":"integer","description":"Volume in last 6 hours"},"vol_9h":{"type":"integer","description":"Volume in last 9 hours"},"vol_12h":{"type":"integer","description":"Volume in last 12 hours"},"vol_1d":{"type":"integer","description":"Volume in last 24 hours"},"vol_3d":{"type":"integer","description":"Volume in last 3 days"},"vol_7d":{"type":"integer","description":"Volume in last 7 days"},"vol_30d":{"type":"integer","description":"Volume in last 30 days"},"vol_total":{"type":"integer","description":"Total volume"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/runes/ticker_info":{"get":{"summary":"Get Runes Ticker Information","description":"Returns information about given runes ticker.\nNote: One of rune_name, rune_id or rune_number must be specified.\nNote: 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.\n","parameters":[{"name":"rune_name","in":"query","required":false,"schema":{"type":"string"},"description":"Non-Spaced name of Rune"},{"name":"rune_id","in":"query","required":false,"schema":{"type":"string"},"description":"Rune ID"},{"name":"rune_number","in":"query","required":false,"schema":{"type":"integer"},"description":"Rune Number"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RunesTickerInfo"},"block_height":{"type":"integer","description":"Current block height"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
## Get Runes Market Information
> Returns market information about a specific runes ticker. One of rune\_name, rune\_id, or rune\_number must be provided.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesMarketInfo":{"type":"object","properties":{"marketcap":{"type":"string","nullable":true,"description":"Market capitalization in sats"},"min_listed_unit_price_in_sats":{"type":"string","nullable":true,"description":"Minimum listed unit price across all markets in sats"},"min_listed_unit_price_unisat":{"type":"string","nullable":true,"description":"Minimum listed unit price on Unisat in sats"},"min_listed_unit_price_magiceden":{"type":"string","nullable":true,"description":"Minimum listed unit price on magiceden in sats"},"listed_supply":{"type":"string","nullable":true,"description":"Total supply listed on markets"},"listed_supply_ratio":{"type":"string","nullable":true,"description":"Ratio of listed supply to total supply"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/x/runes/market_info":{"get":{"summary":"Get Runes Market Information","description":"Returns market information about a specific runes ticker. One of rune_name, rune_id, or rune_number must be provided.","parameters":[{"name":"rune_name","in":"query","required":false,"schema":{"type":"string"},"description":"Non-Spaced name of Rune"},{"name":"rune_id","in":"query","required":false,"schema":{"type":"string"},"description":"Rune ID"},{"name":"rune_number","in":"query","required":false,"schema":{"type":"integer"},"description":"Rune Number"}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"required":["rune_name"]},{"required":["rune_id"]},{"required":["rune_number"]}],"properties":{"rune_name":{"type":"string"},"rune_id":{"type":"string"},"rune_number":{"type":"integer"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RunesMarketInfo"},"block_height":{"type":"integer"}}}}}},"403":{"description":"Invalid API Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
## Get Runes Wallet Valid Outputs
> Returns unspent output information of a given wallet.\
> Note: One of 'address' or 'pkscript' must be specified.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesWalletOutput":{"type":"object","properties":{"pkscript":{"type":"string","nullable":true,"description":"Bitcoin script_pub_key"},"wallet_addr":{"type":"string","nullable":true,"description":"Bitcoin wallet address"},"output":{"type":"string","description":"Transaction output in format txid:index"},"rune_ids":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Array of rune IDs"},"balances":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Array of balances"},"min_price":{"type":"integer","nullable":true,"description":"Minimum price across all markets"},"magiceden_price":{"type":"integer","nullable":true,"description":"Price on magiceden market"},"unisat_price":{"type":"integer","nullable":true,"description":"Price on Unisat market"},"rune_names":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Array of rune names without spaces"},"spaced_rune_names":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Array of rune names with spaces"},"decimals":{"type":"array","nullable":true,"items":{"type":"integer"},"description":"Array of decimal places for each rune"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/runes/wallet_valid_outputs":{"get":{"summary":"Get Runes Wallet Valid Outputs","description":"Returns unspent output information of a given wallet.\nNote: One of 'address' or 'pkscript' must be specified.\n","parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin wallet address"},{"name":"pkscript","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin script_pub_key"},{"name":"sort_by","in":"query","required":true,"schema":{"type":"string","enum":["output","min_price","magiceden_price","unisat_price"]}},{"name":"order","in":"query","required":true,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"offset","in":"query","required":true,"schema":{"type":"integer","minimum":0}},{"name":"count","in":"query","required":true,"schema":{"type":"integer","minimum":20,"maximum":2000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RunesWalletOutput"}},"block_height":{"type":"integer"}}}}}},"403":{"description":"Invalid API Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
## 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.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesWalletBalance":{"type":"object","properties":{"pkscript":{"type":"string","description":"Bitcoin script_pub_key"},"wallet_addr":{"type":"string","description":"Bitcoin wallet address"},"rune_id":{"type":"string","description":"Unique identifier for the rune"},"total_balance":{"type":"string","description":"Total balance of the rune"},"rune_name":{"type":"string","description":"Name of the rune without spaces"},"spaced_rune_name":{"type":"string","description":"Name of the rune with spaces"},"decimals":{"type":"integer","description":"Number of decimal places for the rune"},"avg_unit_price_in_sats":{"type":"string","nullable":true,"description":"Average unit price in satoshis (scaled by decimals)"},"min_listed_unit_price_in_sats":{"type":"string","nullable":true,"description":"Minimum listed unit price in satoshis (scaled by decimals)"},"min_listed_unit_price_magiceden":{"type":"string","nullable":true,"description":"Minimum listed unit price on Unisat (scaled by decimals)"},"min_listed_unit_price_unisat":{"type":"string","nullable":true,"description":"Minimum listed unit price on Unisat (scaled by decimals)"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/runes/wallet_balances":{"get":{"summary":"Get Runes Wallet Balances","description":"Returns runes balance information about given bitcoin wallet address or pkscript.\nNote: One of address or pkscript must be specified.\nNote: avg_unit_price_in_sats and min_listed_unit_price_in_sats is scaled by decimals.\n","parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin wallet address"},{"name":"pkscript","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin script_pub_key"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RunesWalletBalance"}},"block_height":{"type":"integer","description":"Current block height"}}}}}},"403":{"description":"Invalid API Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
## Get Runes Wallet Activity
> 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.
```json
{"openapi":"3.0.0","info":{"title":"Ordinals & Runes Compatibility API","version":"3.0"},"servers":[{"url":"https://api.ordnull.site/v3","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-Key"}},"schemas":{"RunesWalletActivity":{"type":"object","properties":{"event_type":{"type":"string","description":"Type of event (input or output)","enum":["input","output"]},"txid":{"type":"string","description":"Transaction ID"},"outpoint":{"type":"string","description":"Transaction output in format txid:index"},"pkscript":{"type":"string","description":"Bitcoin script_pub_key"},"wallet_addr":{"type":"string","description":"Bitcoin wallet address"},"rune_id":{"type":"string","description":"Unique identifier for the rune"},"amount":{"type":"string","description":"Amount of runes in the transaction"},"block_height":{"type":"integer","description":"Block height of the transaction"},"block_timestamp":{"type":"string","format":"date-time","description":"Timestamp of the block"},"rune_name":{"type":"string","description":"Name of the rune without spaces"},"spaced_rune_name":{"type":"string","description":"Name of the rune with spaces"},"decimals":{"type":"integer","description":"Number of decimal places for the rune"},"sale_info":{"type":"object","nullable":true,"description":"Information about the sale if this was a sale transaction","properties":{"sale_price":{"type":"integer","description":"Price of the sale in sats"},"sold_to_pkscript":{"type":"string","description":"Bitcoin script_pub_key of the buyer"},"sold_to_wallet_addr":{"type":"string","description":"Bitcoin wallet address of the buyer"},"marketplace":{"type":"string","description":"Name of the marketplace where the sale occurred"}}},"icon_content_url":{"type":"string","nullable":true,"description":"URL for icon content"},"icon_render_url":{"type":"string","nullable":true,"description":"URL for icon render"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{"/runes/wallet_activity":{"get":{"summary":"Get Runes Wallet Activity","description":"Retrieves rune transaction activity for a specified wallet. When a wallet participates in a rune transaction, \nthis endpoint returns all transaction activity, including inputs/outputs involving other wallets.\n\nNote: You must provide either 'address' or 'pkscript' to identify the wallet.\n\nOptional rune filtering is available. To see all wallet activity, leave rune_name, rune_id, and rune_number parameters empty.\nTo filter for specific rune transactions, provide exactly one of these parameters to show only transactions where\nthe specified wallet interacts with that particular rune.\n","parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin wallet address"},{"name":"pkscript","in":"query","required":false,"schema":{"type":"string"},"description":"Bitcoin script_pub_key"},{"name":"rune_name","in":"query","required":false,"schema":{"type":"string"},"description":"Non-Spaced name of Rune"},{"name":"rune_id","in":"query","required":false,"schema":{"type":"string"},"description":"Rune ID"},{"name":"rune_number","in":"query","required":false,"schema":{"type":"integer"},"description":"Rune Number"},{"name":"sort_by","in":"query","required":true,"schema":{"type":"string","enum":["ts"]},"description":"Field to sort by (currently only timestamp is supported)"},{"name":"order","in":"query","required":true,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sort order"},{"name":"offset","in":"query","required":true,"schema":{"type":"integer","minimum":0},"description":"Starting offset for pagination"},{"name":"count","in":"query","required":true,"schema":{"type":"integer","minimum":20,"maximum":2000},"description":"Number of results to return"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RunesWalletActivity"}},"block_height":{"type":"integer","description":"Current block height"}}}}}},"403":{"description":"Invalid API Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
#### **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**](https://www.chaindaq.com/plans) 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.