The emergence of Runes on the Bitcoin blockchain has opened new frontiers in decentralized digital assets. As interest grows, accessing accurate, real-time data about Runes collections becomes essential for investors, developers, and collectors. The Runes API offered through OKX’s Web3 infrastructure enables seamless retrieval of critical metrics such as holder counts, floor prices, transaction volumes, and marketplace links.
This guide dives deep into how to use the Runes API endpoint to fetch comprehensive collection details—ideal for integrating into dashboards, analytics platforms, or personal tracking tools.
Understanding the Runes API Endpoint
The Runes API is designed to deliver structured data about specific Runes tokens deployed on Bitcoin. Whether you're monitoring market trends or building a Web3 application, this endpoint provides reliable access to live metrics.
API Request Details
To retrieve Runes information, send a GET request to the following URL:
https://web3.okx.com/api/v5/mktplace/nft/runes/detailThis endpoint supports batch queries, allowing you to fetch data for multiple Runes at once—perfect for comparing collections or tracking portfolio assets.
👉 Discover real-time Runes analytics with powerful Web3 API tools
Required Request Parameters
You must include at least one parameter in your request to specify which Rune(s) you want to query.
| Parameter | Type | Required | Description |
|---|---|---|---|
runesId | String | Yes | Unique identifier(s) for the Rune. For batch queries, separate multiple IDs with commas (e.g., 840000:3,840000:28) |
🔍 Example: To get data for two Runes with IDs840000:3and840000:28, setrunesId=840000:3,840000:28.
No additional authentication or headers are required for public data access, making integration straightforward for developers.
Interpreting the Response Data
The API returns a JSON object containing detailed information about each requested Rune. Below is a breakdown of all available response fields and their significance.
Core Metadata
runesId: Unique identifier of the Rune (e.g.,840000:3)name: Official name of the Rune collectionspacename: Full Rune name formatted with dots (e.g.,PROTOCOL.BITCOIN)symbol: Ticker symbol used for the Runedivisibility: Number of decimal places supported (indicates whether the token is fungible down to subunits)
Minting & Supply Information
maxMintNumber: Maximum supply cap for the RunemintedNumber: Current number of tokens already mintedlimitPerMint: How many tokens a user can mint per transactiondeployedTime: Unix timestamp when the Rune was deployedstartBlock/endBlock: Blockchain block range during which minting is allowed
These values help assess scarcity and potential future supply inflation—key factors in valuation.
Market Performance Metrics
totalVolume/usdTotalVolume: Total trading volume in BTC and USDmarketCap/usdMarketCap: Estimated market capitalization based on current pricesfloorprice/usdFloorPrice: Lowest listed price in satoshis and USDholders: Total number of unique addresses holding the RunesalesCount: Cumulative number of completed sales
Such metrics are vital for identifying trending collections and evaluating liquidity.
Collection Link
collectionUrl: Direct link to the Rune’s page on OKX’s NFT marketplace
This allows users to explore listings, view ownership history, and make purchases directly.
👉 Access live Runes market data using advanced Web3 APIs
Practical Use Cases for Developers and Analysts
1. Portfolio Tracking Dashboards
Integrate the Runes API into personal finance tools to automatically update portfolio values based on real-time floor prices and market caps.
2. Market Research & Trend Analysis
By pulling holders, salesCount, and totalVolume, analysts can detect early signs of hype or declining interest in specific Runes.
3. Automated Alerts
Set up scripts that monitor changes in mintedNumber or floorprice. For example, trigger notifications when a new batch of tokens is minted or if the price drops below a threshold.
4. Comparative Analytics
Use batch queries to compare multiple Runes side by side—ideal for influencers or content creators publishing review articles or rankings.
Frequently Asked Questions (FAQ)
Q: Can I query more than one Rune at a time?
A: Yes, the API supports batch requests. Just separate multiple runesId values with commas in the request URL.
Q: Is there a rate limit for this API?
A: While public endpoints typically allow generous usage, it's recommended to implement caching and avoid excessive polling. For high-frequency needs, consider enterprise-tier access via OKX Web3 solutions.
Q: What does "divisibility" mean for a Rune?
A: Divisibility defines how many decimal places a Rune supports. A divisibility of 0 means it's indivisible (like an NFT), while higher values allow fractional ownership (like fungible tokens).
Q: How often is the market data updated?
A: Data is refreshed in near real-time, typically within seconds after on-chain activity occurs.
Q: Can I use this data commercially?
A: Yes, publicly available API data can be used in commercial applications, dashboards, or research reports, provided proper attribution and compliance with terms of service.
Q: Where can I view the actual NFTs in a Runes collection?
A: Use the collectionUrl field returned in the response to open the collection on OKX’s NFT marketplace and browse individual items.
Why This Matters for Web3 Builders
As the Bitcoin ecosystem evolves, tools like the Runes API empower developers to build next-generation financial and social applications. From decentralized exchanges to community-driven launchpads, having access to standardized, structured data accelerates innovation.
Moreover, combining this API with others in OKX’s Web3 suite—such as wallet services (WaaS), transaction tracking, or marketplace integrations—enables full-stack development without relying on third-party scrapers or unreliable sources.
👉 Unlock advanced Runes and NFT insights with scalable Web3 APIs
Final Thoughts
The Runes protocol brings tokenization capabilities natively to Bitcoin, and with it comes a growing need for transparent, accessible data. The Runes API makes it easy to stay informed about collection performance, user adoption, and market dynamics—all through a simple, well-documented endpoint.
Whether you're a developer building the next big Bitcoin dApp or a collector tracking your favorite Runes, leveraging this API gives you a strategic edge in the fast-moving world of Web3.
By focusing on core keywords like Runes collection, Runes API, Marketplace API, Web3 API, NFT analytics, Bitcoin tokens, and OKX Web3, this guide ensures discoverability while delivering practical value aligned with search intent.