User Guide
Synapse-Etherscan User Guide
Synapse-Etherscan adds new Storm commands to allow you to query the Etherscan API using your existing API key.
Getting Started
Check with your Admin to enable permissions and find out if you need a personal API key.
Examples
Setting your personal API key
To set-up a personal use API key:
> etherscan.setup.apikey eth --self myapikey
Setting Etherscan (eth) API key for the current user.
Use Etherscan to enrich nodes
Enrich a crypto:currency:address node with etherscan.enrich and yield the results:
> [ crypto:currency:address=(eth, 0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210) ] | etherscan.enrich --yield --size 3
WARNING: The property econ:acct:balance:crypto:address is deprecated or using a deprecated type and will be removed in 3.0.0
crypto:currency:transaction=3d60f43557d72b66f873d140f3541d6e
.created = 2025/06/27 15:09:19.970
:block = eth/12971814
:block:coin = eth
:block:offset = 12971814
:eth:gaslimit = 207128
:eth:gasprice = 0.000000062
:eth:gasused = 21000
:from = eth/0xDFd5293D8e347dFe59E90eFd55b2956a1343963d
:hash = f45b8ff1335fad160e00cba42df67462101b1353eee96e21e2c5168a84a7a3a9
:success = true
:time = 2021/08/06 14:00:24.000
:to = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
:value = 4.0965
crypto:currency:transaction=a416dc317462a38cc114f0574e0c9e16
.created = 2025/06/27 15:09:19.983
:block = eth/12971837
:block:coin = eth
:block:offset = 12971837
:contract:input = sha256:27c28a1d7429e3db79ec1aebe196de7be355143c9bc9ad29d2712797099f79ee
:eth:gaslimit = 215887
:eth:gasprice = 0.000000052320218757
:eth:gasused = 163754
:from = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
:hash = 6ca2643fd1dbb23daa43b306fdc20f72db616be5e775cdf1c96e6352d139c59d
:success = true
:time = 2021/08/06 14:06:41.000
:to = eth/0x1A2a1c938CE3eC39b6D47113c7955bAa9DD454F2
:value = 2.4
crypto:currency:transaction=f192d0d056494c68aa07147a2f909903
.created = 2025/06/27 15:09:19.995
:block = eth/12971864
:block:coin = eth
:block:offset = 12971864
:eth:gaslimit = 21000
:eth:gasprice = 0.000000051
:eth:gasused = 21000
:from = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
:hash = 7e3df29a81e8ec78d7fb53194c3e9692e1fa88301a6ad900d7bbc52f40ca99eb
:success = true
:time = 2021/08/06 14:13:29.000
:to = eth/0xc073D4d22C851c662A963E398022Bf138555303c
:value = 1.55
Query multiple chains using a hash argument and yield the results:
> etherscan.enrich.hash 0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0 --coin eth polygon --size 2 --yield
WARNING: The property econ:acct:balance:crypto:address is deprecated or using a deprecated type and will be removed in 3.0.0
crypto:currency:transaction=5eb88169dbefb82ab32493f07a189e70
.created = 2025/06/27 15:09:20.389
:block = eth/13055340
:block:coin = eth
:block:offset = 13055340
:eth:gaslimit = 21000
:eth:gasprice = 0.000000029124495648
:eth:gasused = 21000
:from = eth/0xDDB833b9e0e3f2F521480e7Bcb3e676E0737047d
:hash = 1f3fadee389f8393991e71974145a5fa2de049ed0a6264a9da879f1c97df3d51
:success = true
:time = 2021/08/19 11:08:52.000
:to = eth/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:value = 4.319765525314957809
crypto:currency:transaction=df23226f953c4cac2acacbb2664a47a4
.created = 2025/06/27 15:09:20.399
:block = eth/13056982
:block:coin = eth
:block:offset = 13056982
:contract:input = sha256:e8c05ca256a4cece99a2da695899ecdf753b7995cd124a0189f1e57886c8e415
:eth:gaslimit = 2156471
:eth:gasprice = 0.000000073534170823
:eth:gasused = 2078783
:from = eth/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:hash = be9d1e2c39412f3a5d31e6083b1c8ac84d56c4ee6e3ba29dd94f6f449f6618db
:success = true
:time = 2021/08/19 17:10:55.000
:to = eth/0x86E4Dc95c7FBdBf52e33D563BbDB00823894C287
:value = 0
crypto:currency:transaction=0b41ee119d6f4e8d6577b55d8b61434c
.created = 2025/06/27 15:09:20.432
:block = polygon/18654325
:block:coin = polygon
:block:offset = 18654325
:eth:gaslimit = 21000
:eth:gasprice = 0.00000003
:eth:gasused = 21000
:from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:hash = edf831328291b404b69b0b41360fdafbb7e8f98beb87b916d5415a90df316306
:success = true
:time = 2021/09/02 07:41:44.000
:to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
:value = 44211.438807197944577722
crypto:currency:transaction=485ecfba1adb90cc4791ff35549218af
.created = 2025/06/27 15:09:20.442
:block = polygon/18711859
:block:coin = polygon
:block:offset = 18711859
:eth:gaslimit = 21000
:eth:gasprice = 0.000000001000000001
:eth:gasused = 21000
:from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:hash = 9d3b0b478fcc62d62328ab92038809e0b0417ecaa24d381d4d6b8749fcebaaff
:success = true
:time = 2021/09/03 19:31:25.000
:to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
:value = 4407.901439470710765904
Use of meta:source nodes
Synapse-Etherscan uses a meta:source node and -(seen)> light
weight edges to track nodes observed from the Etherscan API.
> meta:source=2dddff51304a19ce0bc77a1c9cfd22bb
meta:source=2dddff51304a19ce0bc77a1c9cfd22bb
.created = 2025/06/27 15:09:19.946
:name = etherscan api
Storm can be used to filter nodes to include/exclude nodes which have been observed by Synapse-Etherscan. The following example shows how to filter the results of a query to include only results observed by Synapse-Etherscan:
> crypto:currency:coin=polygon -> crypto:currency:transaction +{ <(seen)- meta:source=2dddff51304a19ce0bc77a1c9cfd22bb }
crypto:currency:transaction=485ecfba1adb90cc4791ff35549218af
.created = 2025/06/27 15:09:20.442
:block = polygon/18711859
:block:coin = polygon
:block:offset = 18711859
:eth:gaslimit = 21000
:eth:gasprice = 0.000000001000000001
:eth:gasused = 21000
:from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:hash = 9d3b0b478fcc62d62328ab92038809e0b0417ecaa24d381d4d6b8749fcebaaff
:success = true
:time = 2021/09/03 19:31:25.000
:to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
:value = 4407.901439470710765904
crypto:currency:transaction=0b41ee119d6f4e8d6577b55d8b61434c
.created = 2025/06/27 15:09:20.432
:block = polygon/18654325
:block:coin = polygon
:block:offset = 18654325
:eth:gaslimit = 21000
:eth:gasprice = 0.00000003
:eth:gasused = 21000
:from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
:hash = edf831328291b404b69b0b41360fdafbb7e8f98beb87b916d5415a90df316306
:success = true
:time = 2021/09/02 07:41:44.000
:to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
:value = 44211.438807197944577722