SoChain
Live Bitcoin, Litecoin, Dogecoin and Zcash data: balances, transactions, blocks, fees, prices.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,475Tokens (tool definitions)
~3.2 KBTypical response size
Significant attention impact (5.84% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://sochain.com/mcp"
}
}
}Remote endpoints
https://sochain.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (20)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_balance(network, address, height, time)
Confirmed and unconfirmed balance of an address; with height or time, its confirmed balance at that point (for example at the end of a year).
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"height": {
"type": "integer",
"minimum": 0,
"description": "Optional: the confirmed balance at the end of this block instead."
},
"time": {
"type": "string",
"description": "Optional: the confirmed balance at this time instead (a date means the end of that day): unix seconds, a date like 2025-12-31 (UTC) or a timestamp like 2025-12-31T23:59:59Z."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"confirmed": {
"type": "string"
},
"unconfirmed": {
"type": "string"
},
"address": {
"type": "string"
},
"height": {
"type": [
"integer",
"null"
]
},
"time": {
"type": [
"integer",
"null"
]
},
"block_hash": {
"type": [
"string",
"null"
]
},
"tip_height": {
"type": "integer"
}
},
"required": [
"confirmed"
]
}🟢get_address_summary(network, address)
Totals for an address: balance, total received, and how many transactions sent and received.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"txs_sent": {
"type": "integer"
},
"txs_received": {
"type": "integer"
},
"txs_total": {
"type": "integer"
},
"confirmed_balance": {
"type": "string"
},
"unconfirmed_balance": {
"type": "string"
},
"confirmed_received": {
"type": "string"
},
"first_active": {
"type": [
"object",
"null"
],
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
}
}
},
"last_active": {
"type": [
"object",
"null"
],
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
}
}
}
},
"required": [
"txs_sent",
"txs_received",
"txs_total",
"confirmed_balance",
"unconfirmed_balance",
"confirmed_received"
]
}🟢get_transaction_counts(network, address)
How many transactions an address has sent, received, and in total.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"sent": {
"type": "integer"
},
"received": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"sent",
"received",
"total"
]
}🟢get_transactions(network, address, page, from_height, to_height, ...)
An address's transactions, newest first (unconfirmed first), with the amount each one moved for the address and the price at the time (USD unless currency is given). Without filters, pages by number; with any filter (block or time range, direction), pages by cursor: pass next_cursor back until it's null (a short page with a cursor isn't the end).
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (10 per page). Default 1."
},
"from_height": {
"type": "integer",
"minimum": 0,
"description": "Oldest block to include."
},
"to_height": {
"type": "integer",
"minimum": 0,
"description": "Newest block to include."
},
"from_time": {
"type": "string",
"description": "Start (a date means from its first second): unix seconds, a date like 2025-12-31 (UTC) or a timestamp like 2025-12-31T23:59:59Z."
},
"to_time": {
"type": "string",
"description": "End (a date means to its last second): unix seconds, a date like 2025-12-31 (UTC) or a timestamp like 2025-12-31T23:59:59Z."
},
"direction": {
"type": "string",
"enum": [
"in",
"out",
"both"
],
"description": "in: the balance went up; out: it went down (a payment with change counts once, as out). Default both."
},
"unconfirmed": {
"type": "string",
"enum": [
"include",
"exclude",
"only"
],
"description": "Mempool transactions. Default include, or exclude when there's an end (to_height or to_time)."
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Rows per page, default 10."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page; it carries the filters."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional: prices in this currency instead of USD."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"transactions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hash": {
"type": "string"
},
"value_sent": {
"type": "string"
},
"value_received": {
"type": "string"
},
"balance_change": {
"type": "string"
},
"time": {
"type": "integer"
},
"block": {
"type": [
"integer",
"null"
]
},
"price": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"currency": {
"type": "string"
}
}
}
},
"required": [
"hash",
"balance_change",
"time",
"block"
]
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"page_size": {
"type": "integer"
},
"from_height": {
"type": [
"integer",
"null"
]
},
"to_height": {
"type": [
"integer",
"null"
]
},
"direction": {
"type": "string"
},
"unconfirmed": {
"type": "string"
},
"tip_height": {
"type": "integer"
}
},
"required": [
"transactions"
]
}🟢get_unspent_outputs(network, address, page)
The coins (unspent outputs) an address can spend, oldest first.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (10 per page). Default 1."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"outputs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hash": {
"type": "string"
},
"index": {
"type": "integer"
},
"script": {
"type": "string"
},
"address": {
"type": [
"string",
"null"
]
},
"value": {
"type": "string"
},
"block": {
"type": [
"integer",
"null"
]
},
"tx_hex": {
"type": "string"
}
},
"required": [
"hash",
"index",
"value"
]
}
}
},
"required": [
"outputs"
]
}🟢get_transaction(network, hash, currency)
A transaction: confirmations, block, fee, inputs and outputs (is_change marks outputs paying back to an input address).
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"hash": {
"type": "string",
"description": "The 64-character transaction ID (hash)."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional: prices in this currency instead of USD."
}
},
"required": [
"network",
"hash"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"hash": {
"type": "string"
},
"confirmations": {
"type": "integer"
},
"size": {
"type": "integer"
},
"vsize": {
"type": "integer"
},
"weight": {
"type": "integer"
},
"version": {
"type": "integer"
},
"locktime": {
"type": "integer"
},
"block_hash": {
"type": [
"string",
"null"
]
},
"block_height": {
"type": [
"integer",
"null"
]
},
"time": {
"type": "integer"
},
"inputs_n": {
"type": "integer"
},
"outputs_n": {
"type": "integer"
},
"inputs_value": {
"type": "string"
},
"outputs_value": {
"type": "string"
},
"fee": {
"type": "string"
},
"price": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"currency": {
"type": "string"
}
}
},
"facts": {
"type": "object",
"properties": {
"bridge": {
"type": "string"
},
"protocol": {
"type": "string"
}
},
"required": []
},
"kind": {
"type": [
"string",
"null"
]
},
"heuristic": {
"type": [
"boolean",
"null"
]
},
"inputs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"type": "integer"
},
"value": {
"type": "string"
},
"address": {
"type": [
"string",
"null"
]
},
"scriptSig": {
"type": "object",
"properties": {
"hex": {
"type": "string"
},
"asm": {
"type": "string"
}
}
},
"witness": {
"type": "array",
"items": {
"type": "string"
}
},
"previous_output": {
"type": [
"object",
"null"
],
"properties": {
"hash": {
"type": "string"
},
"index": {
"type": "integer"
}
}
},
"sequence": {
"type": "integer"
}
},
"required": [
"index",
"value"
]
}
},
"outputs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"type": "integer"
},
"value": {
"type": "string"
},
"address": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"script": {
"type": "object",
"properties": {
"hex": {
"type": "string"
},
"asm": {
"type": "string"
}
}
},
"spent": {
"type": [
"object",
"null"
],
"properties": {
"hash": {
"type": "string"
},
"index": {
"type": "integer"
}
}
},
"is_change": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"index",
"value"
]
}
}
},
"required": [
"hash",
"confirmations",
"fee",
"inputs",
"outputs"
]
}🟢get_transaction_status(network, hash)
A transaction's status: pending, mined, replaced (another transaction spent one of its inputs, as in a fee bump or double spend; replaced_by names it), dropped, or expired (Zcash). SoChain remembers a removal for about a day; after that, or for a transaction it never saw, the status is unknown.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"hash": {
"type": "string",
"description": "The 64-character transaction ID (hash)."
}
},
"required": [
"network",
"hash"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"network": {
"type": "string"
},
"hash": {
"type": "string"
},
"status": {
"type": "string"
},
"block_height": {
"type": [
"integer",
"null"
]
},
"confirmations": {
"type": [
"integer",
"null"
]
},
"replaced_by": {
"type": [
"string",
"null"
]
},
"replaced_by_status": {
"type": [
"string",
"null"
]
},
"replaced_by_height": {
"type": [
"integer",
"null"
]
},
"replaced_ancestor": {
"type": [
"string",
"null"
]
},
"removed_at": {
"type": [
"integer",
"null"
]
}
},
"required": [
"network",
"hash",
"status",
"block_height",
"confirmations",
"replaced_by",
"replaced_by_status",
"replaced_by_height",
"replaced_ancestor",
"removed_at"
]
}🟢get_block(network, block, currency)
A block by height or hash: time, transactions, size, reward, fees, miner.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"block": {
"type": "string",
"description": "Block height (number) or 64-character block hash."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional: prices in this currency instead of USD."
}
},
"required": [
"network",
"block"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"hash": {
"type": "string"
},
"time": {
"type": "integer"
},
"confirmations": {
"type": "integer"
},
"num_txs": {
"type": "integer"
},
"size": {
"type": "integer"
},
"weight": {
"type": "integer"
},
"version": {
"type": "integer"
},
"nonce": {
"type": [
"integer",
"string"
]
},
"previous_block_hash": {
"type": [
"string",
"null"
]
},
"next_block_hash": {
"type": [
"string",
"null"
]
},
"is_orphan": {
"type": "boolean"
},
"difficulty": {
"type": "string"
},
"merkleroot": {
"type": "string"
},
"bits": {
"type": "string"
},
"reward": {
"type": "string"
},
"fees": {
"type": "string"
},
"value_out": {
"type": "string"
},
"min_fee_rate": {
"type": [
"integer",
"null"
]
},
"median_fee_rate": {
"type": [
"integer",
"null"
]
},
"max_fee_rate": {
"type": [
"integer",
"null"
]
},
"txs": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"currency": {
"type": "string"
}
}
},
"kinds": {
"type": "object"
}
},
"required": [
"height",
"hash",
"time",
"confirmations",
"num_txs"
]
}🟢get_latest_blocks(network, currency)
The ten newest blocks with their size, transaction count, reward and miner.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional: prices in this currency instead of USD."
}
},
"required": [
"network"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"blocks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
},
"num_txs": {
"type": "integer"
},
"size": {
"type": "integer"
},
"weight": {
"type": "integer"
},
"version": {
"type": "integer"
},
"difficulty": {
"type": "string"
},
"price": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"currency": {
"type": "string"
}
}
},
"miner": {
"type": [
"string",
"null"
]
},
"reward_and_fees": {
"type": "string"
},
"kinds": {
"type": "object"
}
},
"required": [
"height",
"time",
"num_txs"
]
}
}
},
"required": [
"blocks"
]
}🟢get_best_block_hash(network)
The hash of the newest block.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
}
},
"required": [
"network"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"hash": {
"type": "string"
}
},
"required": [
"hash"
]
}🟢get_network_info(network)
Current height, hashrate, and the mempool: waiting transactions, size, and projected next blocks with fee rates.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
}
},
"required": [
"network"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"block_count": {
"type": "integer"
},
"best_block_hash": {
"type": "string"
},
"hashrate": {
"type": "string"
},
"mempool": {
"type": "object",
"properties": {
"mempool_txs": {
"type": "integer"
},
"mempool_size": {
"type": "integer"
},
"updated_at": {
"type": "integer"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"block_num": {
"type": "integer"
},
"min_fee_rate": {
"type": "integer"
},
"median_fee_rate": {
"type": "integer"
},
"max_fee_rate": {
"type": "integer"
},
"min_fee_rate_possible": {
"type": "integer"
},
"weight": {
"type": "integer"
},
"size": {
"type": "integer"
},
"num_txs": {
"type": "integer"
}
},
"required": [
"block_num"
]
}
},
"quote_targets": {
"type": [
"object",
"null"
]
},
"loading": {
"type": "boolean"
}
}
}
},
"required": [
"block_count",
"best_block_hash",
"mempool"
]
}🟢get_price(network, unix_time, currency)
The price in USD (or another currency): the current price, or the UTC-day opening price for a past unix time.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"unix_time": {
"type": "integer",
"description": "Optional unix time for a historical price."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional: prices in this currency instead of USD."
}
},
"required": [
"network"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"value": {
"type": "string"
},
"currency": {
"type": "string"
},
"as_of": {
"type": "integer"
}
},
"required": [
"value",
"currency"
]
}🟢search(network, query)
Classify a search string: an address, a transaction ID, a block hash or a block height.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"query": {
"type": "string",
"description": "An address, a transaction ID or block hash (64 hexadecimal characters), or a block height (commas allowed)."
}
},
"required": [
"network",
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"value": {
"type": "string"
},
"height": {
"type": "integer"
}
},
"required": [
"kind"
]
}🟢get_chart(network, series, interval, from, to, ...)
A chart series: tx_count, fees_total, fees_median, block_size, difficulty, hashrate, supply, price_usd, tx_per_min, block_interval, mempool_txs, mempool_bytes, pool_share, holder_share, new_addresses, active_addresses, transfers, lookalikes, on LTC and LTCTEST mweb_pool (coins in MWEB) and mweb_flows (peg-ins and peg-outs), and on ZEC and ZECTEST zcash_pools (the value in each Zcash pool). Intervals: block (last 1,000 blocks), hour (90 days), day (full history), minute (last hour; tx_per_min and mempool series only).
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"series": {
"type": "string",
"enum": [
"tx_count",
"fees_total",
"fees_median",
"block_size",
"difficulty",
"hashrate",
"supply",
"price_usd",
"tx_per_min",
"block_interval",
"pool_share",
"lookalikes",
"mempool_txs",
"mempool_bytes",
"holder_share",
"new_addresses",
"active_addresses",
"transfers",
"mweb_pool",
"mweb_flows",
"zcash_pools"
],
"description": "The series, as listed above: mweb_pool and mweb_flows on Litecoin only, zcash_pools on Zcash only."
},
"interval": {
"type": "string",
"enum": [
"block",
"minute",
"hour",
"day"
],
"description": "Each point's span: block (the last 1,000 blocks), minute (the last hour), hour (90 days) or day (the full history)."
},
"from": {
"type": "integer",
"description": "Optional start: block height for the block interval, else unix time."
},
"to": {
"type": "integer",
"description": "Optional end, same units as from."
},
"currency": {
"type": "string",
"enum": [
"AUD",
"BRL",
"CAD",
"CHF",
"CNY",
"CZK",
"DKK",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"ISK",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PHP",
"PLN",
"RON",
"SEK",
"SGD",
"THB",
"TRY",
"USD",
"ZAR"
],
"description": "Optional, price_usd only: the price in this currency instead of USD."
}
},
"required": [
"network",
"series",
"interval"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"series": {
"type": "string"
},
"interval": {
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"t": {
"type": "integer"
},
"v": {
"type": [
"string",
"number",
"object",
"null"
]
},
"height": {
"type": "integer"
},
"provisional": {
"type": "boolean"
}
},
"required": [
"t",
"v"
]
}
}
},
"required": [
"series",
"interval",
"points"
]
}🟢is_valid_address(network, address)
Whether a string is a valid address on the network.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"is_valid": {
"type": "boolean"
}
},
"required": [
"is_valid"
]
}🟢get_rich_list(network, page, page_size)
The largest holders: the top 1,000 addresses by confirmed balance, with each one's share of the supply, transactions, first and last activity, and change over 24 hours and 7 days.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page, default 1 (up to 1,000 ÷ page_size)."
},
"page_size": {
"type": "integer",
"enum": [
25,
50,
100
],
"description": "25, 50 or 100 (the default)."
}
},
"required": [
"network"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
},
"supply": {
"type": "string"
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total_rows": {
"type": "integer"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer"
},
"address": {
"type": "string"
},
"balance": {
"type": "string"
},
"share_of_supply": {
"type": [
"number",
"null"
]
},
"tx_count": {
"type": "integer"
},
"received": {
"type": "string"
},
"sent": {
"type": "string"
},
"first_seen": {
"type": [
"object",
"null"
],
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
}
}
},
"last_seen": {
"type": [
"object",
"null"
],
"properties": {
"height": {
"type": "integer"
},
"time": {
"type": "integer"
}
}
},
"delta_24h": {
"type": [
"string",
"null"
]
},
"delta_7d": {
"type": [
"string",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"rank",
"address",
"balance"
]
}
}
},
"required": [
"height",
"time",
"supply",
"page",
"page_size",
"total_rows",
"rows"
]
}🟢get_address_rank(network, address)
Where an address stands among the largest holders (exact within the top 10,000) and its share of the supply.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"address": {
"type": "string"
},
"balance": {
"type": "string"
},
"rank": {
"type": [
"integer",
"null"
]
},
"rank_limit": {
"type": "integer"
},
"share_of_supply": {
"type": [
"number",
"null"
]
}
},
"required": [
"address",
"balance",
"rank",
"rank_limit",
"share_of_supply"
]
}🟢get_balance_history(network, address, interval, from, to)
An address's confirmed balance by day, week or month, with what came in and went out in each and how many transactions did each. Without an API key at most 2,000 points (daily: the most recent days unless from says otherwise); with one, 20,000.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"interval": {
"type": "string",
"enum": [
"day",
"week",
"month"
],
"description": "Default day."
},
"from": {
"type": "string",
"description": "Optional start: unix seconds, a date like 2025-12-31 (UTC) or a timestamp like 2025-12-31T23:59:59Z."
},
"to": {
"type": "string",
"description": "Optional end (a date means its last second): unix seconds, a date like 2025-12-31 (UTC) or a timestamp like 2025-12-31T23:59:59Z."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"address": {
"type": "string"
},
"interval": {
"type": "string"
},
"resolution_blocks": {
"type": "integer"
},
"exact_resolution": {
"type": "boolean"
},
"tx_counts_available": {
"type": "boolean"
},
"external_available": {
"type": "boolean"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"t": {
"type": "integer"
},
"height": {
"type": "integer"
},
"v": {
"type": "string"
},
"received": {
"type": [
"string",
"null"
]
},
"sent": {
"type": [
"string",
"null"
]
},
"tx_in": {
"type": [
"integer",
"null"
]
},
"tx_out": {
"type": [
"integer",
"null"
]
},
"received_external": {
"type": [
"string",
"null"
]
},
"sent_external": {
"type": [
"string",
"null"
]
}
},
"required": [
"t",
"v"
]
}
}
},
"required": [
"address",
"interval",
"points"
]
}🟢get_address_poisoning(network, address, limit)
Whether an address was targeted by address poisoning: look-alike addresses that sent it dust, imitating an address it really paid or was paid by, so a careless copy from its history pays the scammer. Each finding names the look-alike, whom it imitates and the real payment.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Findings, default 50, newest first."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"address": {
"type": "string"
},
"building": {
"type": "boolean"
},
"findings": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"address",
"building",
"findings"
]
}🟢get_counterparties(network, address, limit)
Who an address moved significant amounts to and from lately (the window the poisoning check watches), newest first.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"BTC",
"LTC",
"DOGE",
"ZEC",
"BTCTEST",
"LTCTEST",
"DOGETEST",
"ZECTEST"
],
"description": "Network: BTC, LTC, DOGE, ZEC, BTCTEST, LTCTEST, DOGETEST or ZECTEST."
},
"address": {
"type": "string",
"description": "An address on that network."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Rows, default 50."
}
},
"required": [
"network",
"address"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"address": {
"type": "string"
},
"window_blocks": {
"type": "integer"
},
"from_height": {
"type": "integer"
},
"building": {
"type": "boolean"
},
"counterparties": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"direction": {
"type": "string"
},
"amount": {
"type": "string"
},
"txid": {
"type": "string"
},
"height": {
"type": "integer"
}
},
"required": [
"address"
]
}
}
},
"required": [
"address",
"counterparties"
]
}Community
Evidence
Recent observations
verifiedversion not recorded20 tools