From obul-crypto
USE THIS SKILL WHEN: the user wants to query Bitcoin Ordinals inscriptions, runes, BRC-20 balances, rare sats, or UTXOs. Provides pay-per-use Bitcoin data via Ordiscan through the Obul proxy.
How this skill is triggered — by the user, by Claude, or both
Slash command
/obul-crypto:ordiscanThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Ordiscan provides pay-per-request Bitcoin Ordinals and Runes data. Query inscriptions, rune balances, BRC-20 tokens, rare sats, and UTXOs by address. No API key needed — payment is handled automatically via `obulx`.
Ordiscan provides pay-per-request Bitcoin Ordinals and Runes data. Query inscriptions, rune balances, BRC-20 tokens, rare sats, and UTXOs by address. No API key needed — payment is handled automatically via obulx.
All requests use the obulx CLI, which handles x402 payment automatically.
Retrieve details about a specific inscription by its ID.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/inscription/b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0"
Response: JSON with inscription details including content type, content URL, sat number, owner address, and genesis transaction.
List all inscriptions owned by a Bitcoin address.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/inscriptions"
Response: JSON array of inscription IDs and metadata owned by the address.
Retrieve UTXOs for a Bitcoin address with ordinals info.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/utxos"
Response: JSON array of UTXOs with associated inscriptions and runes tied to each output.
Retrieve rune balances for a Bitcoin address.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/runes"
Response: JSON array of rune balances in the smallest denomination (no decimals).
Retrieve BRC-20 token balances for a Bitcoin address.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/brc20"
Response: JSON array of BRC-20 token balances with ticker and amount.
Find rare sats in a Bitcoin address.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/rare-sats"
Response: JSON array of rare sats with rarity classification and sat number.
Get inscription transfer history for a Bitcoin address.
Pricing: $0.01
Request:
obulx "https://api.ordiscan.com/v1/address/bc1pxaneaf3w4d27hl2y93fuft2xk6m4u3wc4rafevc6slgd7f5tq2dqyfgy06/transfers"
Response: JSON array of inscription transfers for the address.
| Endpoint | Price | Purpose |
|---|---|---|
GET /v1/inscription/{id} | $0.01 | Get inscription by ID |
GET /v1/address/{address}/inscriptions | $0.01 | List address inscriptions |
GET /v1/address/{address}/utxos | $0.01 | Get address UTXOs |
GET /v1/address/{address}/runes | $0.01 | Get rune balances |
GET /v1/address/{address}/brc20 | $0.01 | Get BRC-20 balances |
GET /v1/address/{address}/rare-sats | $0.01 | Get rare sats |
GET /v1/address/{address}/transfers | $0.01 | Get inscription transfers |
obulx CLI handles x402 payment automatically -- no USDC wallet or payment header needed.| Error | Cause | Solution |
|---|---|---|
402 Payment Required | Payment not processed or insufficient | Verify your obulx setup is correct and your account has sufficient balance at my.obul.ai. |
400 Bad Request | Invalid address format | Ensure the Bitcoin address is in a valid format. |
404 Not Found | Address or inscription not found | Verify the address or inscription ID is correct. |
429 Too Many Requests | Rate limit exceeded | Add a short delay between requests. |
500 Internal Server Error | Ordiscan service issue | Wait a few seconds and retry. If persistent, the service may be experiencing downtime. |
npx claudepluginhub polymerdao/pay-plugin --plugin obul-cryptoCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.