API « Ordinals & Runes »
Présentation générale
The Ordinals & Runes API is a Quicknode product that provides access to Bitcoin Ordinals inscriptions and Runes fungible tokens. Quicknode exposes this API supporting both REST and JSON-RPC interfaces.
How to Access the Ordinals & Runes API
To enable the Ordinals & Runes API on your Quicknode endpoint:
- Accédez à votre Quicknode
- Select your Bitcoin endpoint (or create a new one)
- Accédez à l'onglet « Extensions »
- Open Ordinals & Runes API in the Quicknode dashboard and enable it
Once enabled, the Ordinals & Runes API is accessible via your endpoint URL using this endpoint path: /addon/679/
Interfaces prises en charge
API REST
The REST API provides a familiar HTTP interface with path parameters for querying inscriptions, runes, sats, and block data.
Base : /addon/679/
Le Accept: application/json header is required for all REST API requests.
Exemple :
curl -X GET \
"https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/679/status" \
-H "Accept: application/json"
API JSON-RPC
The JSON-RPC API wraps Ordinals methods behind standard JSON-RPC calls (e.g., ord_getInscription, ord_getRune). Cela s'avère utile si votre application utilise déjà JSON-RPC pour d'autres interactions avec la blockchain.
Exemple :
curl -X POST \
"https://YOUR_QUICKNODE_ENDPOINT_HERE.com" \
-H "Content-Type: application/json" \
--data '{"method":"ord_getBlockHash","params":["800000"],"id":1,"jsonrpc":"2.0"}'
Mappage des méthodes REST vers RPC
| Endpoint REST | Méthode JSON-RPC |
|---|---|
GET /collections/{page} | ord_getCollections |
GET /content/{inscription_id} | ord_getContent |
GET /inscription/{inscription_id} | ord_getInscription |
GET /inscriptions/{page} | ord_getInscriptions |
GET /inscriptions/block/{blockheight}/{page} | ord_getInscriptionsByBlock |
GET /output/{outpoint} | ord_getOutput |
GET /r/blockhash | ord_getCurrentBlockHash |
GET /r/blockhash/{blockheight} | ord_getBlockHash |
GET /r/blockheight | ord_getCurrentBlockHeight |
GET /r/blockinfo/{blockheight} | ord_getBlockInfo |
GET /r/blocktime | ord_getCurrentBlockTime |
GET /r/children/{inscription_id}/{page} | ord_getChildren |
GET /r/inscription/{inscription_id} | ord_getInscriptionRecursive |
GET /r/metadata/{inscription_id} | ord_getMetadata |
GET /r/sat/{sat}/at/{index} | ord_getSatAtIndex |
GET /r/sat/{sat}/{page} | ord_getSatRecursive |
GET /rune/{runeid} | ord_getRune |
GET /runes/{page} | ord_getRunes |
GET /sat/{sat} | ord_getSat |
GET /status | ord_getStatus |
GET /tx/{txid} | ord_getTx |