WOLFRAM

Wolfram 语言与系统参考资料中心

BlockchainAddressData  (for Bitcoin)

$BlockchainBase = "Bitcoin"

BlockchainAddressData["address"]

给出与比特币区块链上指定地址相关的可用信息.

BlockchainAddressData[assoc]

给出与 assoc 中的指定相匹配的属性的相关信息.

BlockchainAddressData[addressSpec,prop]

给出比特币区块链地址的指定属性.

更多信息

  • 可用以下方式指定区块链上的 address：
  • "address"比特币区块链上的地址
    "chain""address"指定公共区块链上的地址
    {"chain","network"}"address"比特币区块链的特定网络上的地址
  • addressSpec 输入可指代任何输入，无论是 String address 或 Association assoc.
  • 在 BlockchainAddressData[assoc] 中，关联 assoc 可以含有具有以下键的元素：
  • "Address"比特币区块链上的地址
    "TimeInterval"包含哪个时间段内的交易
    "BlockNumberInterval"指定应包含其中的交易的区块间隔
    "BlockNumber"与区块链上特定高度相关的数字
  • 可用属性包括：
  		• "Address"比特币地址
    "Balance"余额的现值，单位为比特币
    "ValueInUSDollars"余额的现值，按美元计
    "TotalUTXO"与该地址关联的未消费的交易输出的总数
    "UTXOList"该地址未消费的交易输出的列表
    "TotalTransactions"与此地址关联的交易的总数
    "TransactionList"此地址最近涉及的交易的列表
  • 如果关联 assoc 含有 "BlockNumber"、"BlockNumberInterval" 或 "TimeInterval"，输出将只包含可用属性的子集.
  • "TransactionList" 给出一个关联，以下属性为键：
  • "TransactionID"交易的哈希
    "BlockNumber"含有此交易的区块的编号
    "Time"区块的时间戳
    "Inputs"交易的输入
    "Outputs"交易的输出
  • 可能的选项包括：
  • BlockchainBase $BlockchainBase设置区块链及其网络
    MaxItems 20最多返回多少项
  • BlockchainAddressData 可以访问比特币的 mainnet 和 testnet. 可使用 BlockchainBase 选项指定区块链及网络.
  • MaxItems 的设置指定了结果中最多包含多少笔交易.

范例

打开所有单元 关闭所有单元

基本范例  (8)

查看主网上的比特币地址：

Wolfram Language code: BlockchainAddressData["14zyue3qxDD7U7x8q2pwKgcbvZe5dvBHBU", BlockchainBase -> "Bitcoin"]//Dataset

用第一个参数指定区块链：

Wolfram Language code: BlockchainAddressData["Bitcoin" -> "14zyue3qxDD7U7x8q2pwKgcbvZe5dvBHBU"]//Dataset

用第一个参数指定区块链及网络：

Wolfram Language code: BlockchainAddressData[{"Bitcoin", "Mainnet"} -> "14zyue3qxDD7U7x8q2pwKgcbvZe5dvBHBU"]//Dataset

获取一个地址的区块高度为 170,000 之前的数据：

Wolfram Language code: BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumber" -> 170000|>, BlockchainBase -> "Bitcoin"]//Dataset

按区块过滤特定地址的交易列表：

Wolfram Language code: BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumberInterval" -> {170000, 200000}|>, "TransactionList", BlockchainBase -> "Bitcoin"]//Dataset

按时间过滤特定地址的交易列表：

Wolfram Language code: BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "TimeInterval" -> {DateObject[{2013, 10, 31, 20, 49, 35.}, "Instant", "Gregorian", -5.], DateObject[{2013, 11, 15, 3, 15, 29.}, "Instant", "Gregorian", -5.]}|>, BlockchainBase -> "Bitcoin"]//Dataset

从 Bitcoin 地址获取属性：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "ValueInUSDollars", BlockchainBase -> "Bitcoin"]

获取比特币地址的多个属性：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", {"Balance", "TotalTransactions"}, BlockchainBase -> "Bitcoin"]

范围  (7)

Address  (1)

获取与所提供的地址匹配的地址：

Wolfram Language code: addresses = {"Alice" -> "15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "Bob" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH" };
Wolfram Language code: BlockchainAddressData["Alice" /. addresses, "Address", BlockchainBase -> "Bitcoin"]

Balance  (1)

获取比特币地址当前的余额：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "Balance", BlockchainBase -> "Bitcoin"]

TotalTransactions  (1)

获取与比特币地址关联的总交易次数：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "TotalTransactions", BlockchainBase -> "Bitcoin"]

TotalUTXO  (1)

获取比特地址的 UTXO 总量：

Wolfram Language code: BlockchainAddressData["3KfRwBSLzeGcZ76SHog2m9Kkhnb6N8dzSc", "TotalUTXO", BlockchainBase -> {"Bitcoin", "Mainnet"}]

TransactionList  (1)

获取与比特币地址关联的交易的列表：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "TransactionList", BlockchainBase -> "Bitcoin", MaxItems -> 5]//Dataset

UTXOList  (1)

获取比特地址的 UTXO 列表：

Wolfram Language code: BlockchainAddressData["3KfRwBSLzeGcZ76SHog2m9Kkhnb6N8dzSc", "UTXOList", BlockchainBase -> {"Bitcoin", "Mainnet"}]//Dataset

ValueInUSDollars  (1)

获取比特币地址当前的余额，以美元计：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "ValueInUSDollars", BlockchainBase -> "Bitcoin"]

选项  (3)

BlockchainBase  (2)

Mainnet  (1)

从 Bitcoin mainnet 地址获取信息：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", BlockchainBase -> {"Bitcoin", "Mainnet"}]//Dataset

Testnet  (1)

查看一个测试网上的比特币地址：

Wolfram Language code: BlockchainAddressData["mroEFGsaCwfRX7oh3vTEm3D8muQ3xRv8ms", BlockchainBase -> {"Bitcoin", "Testnet"}]//Dataset

MaxItems  (1)

列出一个比特币地址最近的 5 笔交易：

Wolfram Language code: BlockchainAddressData["15VREscuZWHb41zzyivw6ZYagMyJ6YKFHd", "TransactionList", BlockchainBase -> "Bitcoin", MaxItems -> 5]//Dataset

应用  (1)

获取指定比特币地址的 "ValueInUSDollars" 属性：

Wolfram Language code: value = BlockchainAddressData["1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru", "ValueInUSDollars", BlockchainBase -> "Bitcoin"]

将金额转换为其他币种：

Wolfram Language code: CurrencyConvert[value, "PeruvianSoles"]

属性和关系  (4)

可用三种不同的形式指定一个比特币地址：

Wolfram Language code: a1 = BlockchainAddressData["1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru", BlockchainBase -> "Bitcoin"];
Wolfram Language code: a2 = BlockchainAddressData["Bitcoin" -> "1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru"];
Wolfram Language code: a3 = BlockchainAddressData[{"Bitcoin", "Mainnet"} -> "1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru"];

它们相互等价：

Wolfram Language code: a1 === a2 === a3

"Address" 属性返回的值与提供的地址相同：

Wolfram Language code: address = "1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru";
Wolfram Language code: BlockchainAddressData[address, "Address", BlockchainBase -> "Bitcoin"] === address

用 "BlockNumber"、"BlockNumberInterval" 或 "TimeInterval" 对地址进行过滤时，输出不会包含所有可用属性，只包含可用属性的子集：

Wolfram Language code: availableProperties = Keys[BlockchainAddressData["17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", BlockchainBase -> "Bitcoin", MaxItems -> 10]]
Wolfram Language code: filteredProperties = Keys[BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumber" -> 170000|>, BlockchainBase -> "Bitcoin", MaxItems -> 10]]
Wolfram Language code: Complement[availableProperties, filteredProperties]//Column

用 "BlockNumber" 对地址进行过滤来指定区块相当于使用从 区块 0 到指定区块的 "BlockNumberInterval"：

Wolfram Language code: res1 = BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumber" -> 170000|>, BlockchainBase -> "Bitcoin"];
Wolfram Language code: res2 = BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumberInterval" -> {0, 170000}|>, BlockchainBase -> "Bitcoin"];
Wolfram Language code: res1 === res2

可能存在的问题  (3)

不存在的地址  (2)

在一个网络中使用另一个网络的地址将返回 Missing：

Wolfram Language code: BlockchainAddressData["1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru", BlockchainBase -> "Bitcoin"]//Dataset
Wolfram Language code: BlockchainAddressData["1P9ZyMW4yyuoaAqLbsyNHdhv2W9H5pbfru", BlockchainBase -> {"Bitcoin", "Testnet"}]

如果地址在区块链中不存在，用区块高度或时间对该地址进行过滤将返回 Missing：

Wolfram Language code: BlockchainAddressData[<|"Address" -> "17xPGgt5BApaDMgUqSnTRka6C95iTbzviH", "BlockNumber" -> 1500|>, BlockchainBase -> "Bitcoin"]

不正确的地址  (1)

如果提供的是无效的地址、公钥或用户名，将返回 $Failed：

Wolfram Language code: BlockchainAddressData["x!=#%", BlockchainBase -> "Bitcoin"]
Wolfram Research (2019)，BlockchainAddressData，Wolfram 语言函数，https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html.

文本

Wolfram Research (2019)，BlockchainAddressData，Wolfram 语言函数，https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html.

CMS

Wolfram 语言. 2019. "BlockchainAddressData." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html.

APA

Wolfram 语言. (2019). BlockchainAddressData. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html 年

BibTeX

@misc{reference.wolfram_2026_blockchainaddressdata, author="Wolfram Research", title="{BlockchainAddressData}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html}", note=[Accessed: 16-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html}, note=[Accessed: 16-September-2026]}