Health of stampchain.io and its indexer: API/DB/mempool/XCP status, indexed vs network block height (isSynced), total stamps and SRC-20 deployments, circuit-breaker state. Call first if other tools error.

A Bitcoin block as the Stamps indexer sees it. block = block index (height) or block hash; leave it empty and set last (1-50) to get the most recent N blocks instead. Returns block_time, hashes, tx_count.

Search stamps by free text (creator name, CPID / asset name such as NAMEDPEPE, stamp number, tx hash fragment). Returns stamp number, CPID, preview URL, mimetype, creator, tx hash. Negative stamp numbers are 'cursed' stamps (pre-protocol-rule artifacts, still indexed).

Paginated stamps, newest first by default (sort DESC/ASC by stamp number). Optional market filters apply to stamps that have market data (floor price in BTC from open dispensers, holder count, 24h volume, data_quality_score 0-10). Each row carries ident (STAMP, SRC-20, SRC-721) so a client can filter by protocol.

One stamp by number, tx hash, or CPID: creator (+ creator_name if registered), supply, locked/divisible flags, mimetype, file hash and size, block and time, stamp_url (the rendered artwork), plus market_data and lowestPriceDispenser when the indexer has them. The base64 image payload is dropped unless include_image_base64=True.

Who holds a stamp: address, amount held, percentage of supply. Supply for most art stamps is 1; SRC-721 and editioned stamps spread across many holders.

Counterparty dispensers for a stamp — the on-chain 'listings'. Each row: source/origin address, give_quantity, give_remaining, escrow_quantity, satoshirate and btcrate (price per unit), status (open/closed), tx hash. An open dispenser with give_remaining > 0 is a live offer; the lowest btcrate among them is the floor. Buying is a wallet action by the user — this tool only reads.

All dispensers a Bitcoin address has opened, optionally filtered by status (open / closed). Useful to see what a seller currently lists.

Transfer history for a stamp. kind='sends' = Counterparty sends (owner to owner); kind='dispenses' = purchases from dispensers (with the BTC paid). Newest first.

Stamps minted in a block — the latest indexed block when block_index is omitted. Good for 'what just got stamped'.

Stamps held by a Bitcoin address, with per-stamp balance and, when available, value (sort_by: DESC/ASC by stamp, value_desc, value_asc, quantity_desc, recent_desc ...). Enhanced with market data by default.

Combined view of a Bitcoin address: its BTC balance, stamps held (with UTXO binding info) and SRC-20 token balances, in one call.

Search SRC-20 tokens by tick fragment. Returns tick, deploy tx, max_supply, total_minted, progress (%), holders, total_mints, and the per-mint limit. mintable_only=True keeps tokens still under 100%.

Recent SRC-20 DEPLOY transactions (newest first): tick, max, lim, decimals, creator, block and time, deploy stamp URL. For a ranked market view use src20_market; for mint progress use get_src20.

Everything about one SRC-20 token in one call: the DEPLOY record (max supply, per-mint limit, decimals, creator, block), mint status (total_minted, progress %, total_mints, holders), and market data (price in BTC/USD, market cap, 24h volume, 24h/7d/30d change, primary exchange, data_quality_score). 7d/30d/total volume are often 0 or null — the upstream exchanges do not publish them; do not read a zero there as 'no trading'.

SRC-20 market data. With tick: that token. Without: a ranked list (sort: market_cap_usd | volume_24h_btc | price_change_24h_percent; order asc/desc). Fields: price BTC/USD, floor (from dispensers), market cap, 24h volume, holder count, circulating supply, 24h/7d/30d change, primary exchange, exchange sources, data_quality_score (0-10), last_updated. Multi-period volumes are unreliable upstream (often 0).

SRC-20 token balances of a Bitcoin address — all ticks, or one tick when given. Amounts are token units (see the deploy's decimals).

Holder snapshot for an SRC-20 tick at the current block: address and amount, largest first. Use for concentration checks (top-10 share).

Valid SRC-20 transactions (DEPLOY / MINT / TRANSFER), newest first. Filter by tick, by op, and/or by block_index. Rows carry creator, destination, amt, tick, stamp number, block_time.

Decode one SRC-20 transaction by its Bitcoin tx hash: op, tick, amounts, creator, destination, validity, block.

SRC-101 deployments — the name-service roots (e.g. BitNameService 'btc' names). Each row: deploy tx hash, root/tick, name, pricing tiers (pri), mint limits, image base URL, creator.

SRC-101 names (Bitcoin Name Service tokens) held by an address. With deploy_hash: names under that specific root (primary name first). Without: every SRC-101 balance the indexer has for the address.

Stamp collections: id, name, description, creators, stamp numbers, stamp_count, total_editions.

One collection by id (hex) or by name, with its stamps and — when include_market_data — floor price, volume and holder metrics.