blockscout-openapi-skill

blockscout-openapi-skill is a skill for Codex from holon-run/uxc. It costs 35 tokens per session (1,137 once invoked), scanned A, original, MIT.

A read-only helper for Blockscout, a website and API for exploring blockchain addresses, tokens, transactions, and blocks. It uses a defined set of Blockscout API operations.

In plain words
What is it for?
Look up an address summary, token balances, or transaction history; inspect token details and holders; and retrieve transaction or block details.
Why use it?
It avoids manually constructing API requests and helps keep exploration limited to supported read operations. It can target a specific Blockscout installation, including self-hosted ones.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/holon-run/uxc/blockscout-openapi-skill
Any agent
npx skills add holon-run/uxc --skill blockscout-openapi-skill
Clone the repo
git clone --depth 1 https://github.com/holon-run/uxc

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for blockscout-openapi-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/holon-run/uxc/blockscout-openapi-skill.svg)](https://agentmods.dev/skills/holon-run/uxc/blockscout-openapi-skill)
Your own site
<a href="https://agentmods.dev/skills/holon-run/uxc/blockscout-openapi-skill"><img src="https://agentmods.dev/badge/skills/holon-run/uxc/blockscout-openapi-skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,137 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.01137
Opus 5 $0.00017 $0.00568
Sonnet 5 $0.00007 $0.00227
Haiku 4.5 $0.00003 $0.00114

Measured 6d ago against content hash 4ae531256aaa, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

blockscout-openapi-skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/validate.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/blockscout-openapi-skill/SKILL.md · 105 lines

How it starts

The opening of the file, as written. The whole thing — 105 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Blockscout Explorer API Skill

Use this skill to run Blockscout explorer operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to a Blockscout deployment that exposes /api/v2.
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
  • A target Blockscout instance. Examples in this skill use https://eth.blockscout.com/api/v2.

Scope

This skill covers a read-first explorer surface:

  • address summary lookup
  • address token balances
  • address transaction history
  • token metadata
  • token holder reads
  • transaction detail lookup
  • block detail lookup

This skill does not cover:

  • Blockscout GraphQL
  • raw JSON-RPC proxying
  • write operations or admin/configuration flows
  • custom authenticated gateways beyond what the caller explicitly binds

Authentication

Public Blockscout instances usually allow explorer reads without auth.

If you are targeting a self-hosted or gateway-protected instance, configure auth separately with standard uxc auth bindings for that host. This skill does not assume any default credential.

Core Workflow

  1. Use the fixed link command by default:

    • command -v blockscout-openapi-cli
    • If missing, create it: uxc link blockscout-openapi-cli https://eth.blockscout.com/api/v2 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
    • blockscout-openapi-cli -h
  2. Inspect operation schema first:

    • blockscout-openapi-cli get:/addresses/{address_hash} -h
    • blockscout-openapi-cli get:/tokens/{address_hash} -h
    • blockscout-openapi-cli get:/transactions/{hash} -h
  3. Prefer narrow lookup validation before larger history reads:

    • blockscout-openapi-cli get:/blocks/{block_number_or_hash} block_number_or_hash=latest
    • blockscout-openapi-cli get:/addresses/{address_hash} address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    • blockscout-openapi-cli get:/tokens/{address_hash} address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Read the full file on GitHub · 105 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 105 lines · 35 tokens per session scan A 4ae531256aaa

Subscribe to this mod's changes

blockscout-openapi-skill is a skill published in the GitHub repository holon-run/uxc (113 stars, last pushed 27d ago), licensed MIT. It adds 35 tokens to every session and 1,137 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

linear

Linear project management — issues, cycles, and projects via GraphQL API.

furkangonel/cowrangler · 17 tokens

binance-tokenized-securities-info

Query Ondo tokenized US stock data on Binance Web3. Covers: supported stock token list, RWA metadata (company info, attestation reports), market and per-asset trading status (with corporate action codes for earnings, dividends, splits), real-time on-chain data (token price, holders, circulating supply, market cap), US…

ccxt/ccxt · 216 tokens

payment-assistant

Binance Pay Assistant - Send and Receive crypto payments. Send: QR code payment from Funding Wallet (C2C + PIX). Use when user wants to buy/purchase/pay/transfer/send, confirm/cancel payment, or query order status. Requires QR code data. PIX QR codes (pix, br.gov.bcb.pix) are auto-detected. Receive: Generate QR codes…

ccxt/ccxt · 119 tokens

ccxt-cli

CCXT command-line interface (ccxt-cli) for interacting with 100+ cryptocurrency exchanges directly from the terminal — no code required. Covers installing the CLI, calling any unified CCXT method (fetchTicker, fetchOHLCV, createOrder, fetchBalance), passing arguments and exchange-specific params, authenticating with…

ccxt/ccxt · 131 tokens

fiat

Query Binance fiat payment capabilities — supported countries, currencies, payment methods, limits, and crypto prices — via public APIs, plus authenticated order/payment history lookup. Use whenever users ask about buying or selling crypto with fiat, depositing or withdrawing fiat, fiat-crypto exchange rates, payment…

ccxt/ccxt · 79 tokens

crypto-market-rank

Crypto market leaderboards — ranked aggregate feeds across the whole market: social-hype/sentiment rank, trending / top-search / Binance Alpha / tokenized-stocks rank, smart-money net-inflow rank (which tokens received the most inflow), top meme tokens by breakout score on Pulse launchpad, top trader PnL leaderboard…

ccxt/ccxt · 129 tokens