WhaleAlertのAPIを使って表示させてみた。

WhaleAlertのAPIを使って表示させてみた。

大量の仮想通貨の移動を感知するとアラートをツイートしてくれるWhaleAlert。

個人利用でも使えるAPIを提供しているので試してみました。
個人利用には無料版と有料版があり、1分間のリクエスト数、検知できる移動金額、取得できるデータの範囲が違います。

個人利用での無料版と有料版の違いを表にまとめました。

無料版 有料版
リクエスト数 1分で10リクエスト 1分で60リクエスト
検知できる
移動金額
500,000ドル以上のトランザクションを検知
金額変更不可
100,000ドル以上のトランザクションを検知
金額指定可能
取得できる履歴 60分前 1日前

利用するにあたって、会員登録をしてAPIで利用するAPIキーの取得が必要です。会員登録後のマイページで取得できます。

リクエストと応答フォーマット

リクエストはGETで投げます。下記のAPIは「transactions」なので対象のトランザクションを全て取得してきます。下記のリクエストフォーマットをブラウザURLに貼り付けてもデータ取得できます。

//リクエストフォーマット
https://api.whale-alert.io/v1/transactions?api_key=自分のAPIキー&min_value=500000&start=UNIXタイムスタンプ

データはjsonで返ってきます。

データがなければ、下記のようなフォーマットが返ってきます。「count」が0なのでデータなしと判別できます。

//データなしの場合
{"result":"success","cursor":"0-0-0","count":0}

データがある場合のフォーマットは、「count」が増えます。

//データありの場合
{"result":"success","cursor":"bca503b-bca503b-5d0b0e79","count":1,"transactions":[{"blockchain":"bitcoin","symbol":"btc","id":"197802129","transaction_type":"transfer","hash":"987caf6d14aad8f30fae632735243769d903c5aaf5a5752497f5442103b65d76","from":{"address":"1GoC1B4GWdbnwzpCFNxqDb2zSL9UzQnwrW","owner_type":"unknown"},"to":{"address":"1H4o9Mh7HyjPa46z4vtv7J8yzaK5RY4bXR","owner_type":"unknown"},"timestamp":1561005588,"amount":69.42331,"amount_usd":646587.4,"transaction_count":1}]}

//取得できるデータのサンプル
//blockchain:bitcoin
//symbol:btc
//id:197802172
//transaction_type:transfer
//hash:2ba48a1f39c41faa0fc7e356fb6f3f6373f8d2f175d21e6ae7555dcc51d6d649
//from:array(address owner_type)
//to:array(address owner_type)
//timestamp:1561005588(int)
//amount:58.107414(float)
//amount_usd:541194.6(float)
//transaction_count:1

動作サンプル

50分前のデータから取得して表示させています(500,000ドル以上のamount_usdであれば表示)。


(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 11:52:51
移動した金額:866485.1ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:53:56
移動した金額:551464.56ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:54:04
移動した金額:500302.9ドル
(1)ETHEREUM
移動元:other ---> exchange:移動先
時刻:2021/02/28 11:54:58
移動した金額:4799986ドル
(1)ETHEREUM
移動元:other ---> exchange:移動先
時刻:2021/02/28 11:54:58
移動した金額:4799989ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:55:25
移動した金額:855960.1ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 11:55:58
移動した金額:989825.4ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:56:00
移動した金額:551464.56ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 11:56:20
移動した金額:4799996ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 11:56:44
移動した金額:559894.4ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:56:58
移動した金額:855960.1ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 11:57:55
移動した金額:856911.9ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 11:58:29
移動した金額:575909.06ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 11:58:29
移動した金額:728520.3ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 11:59:58
移動した金額:718170.06ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 11:59:58
移動した金額:14363600ドル
(1)STELLAR
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:16
移動した金額:1336202.1ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:935478.9ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:7686054ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:3842981ドル
(1)BITCOIN
移動元:other ---> other:移動先
時刻:2021/02/28 12:00:38
移動した金額:11760704ドル
(1)BITCOIN
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:38
移動した金額:4404783ドル
(1)BITCOIN
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:38
移動した金額:1084864.6ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1149159.1ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1271489.4ドル
(1)BITCOIN
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1271489.1ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:613059.5ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1199515.2ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1151055ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:608723.94ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:588254.7ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1073266.4ドル
(1)BITCOIN
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:38
移動した金額:548566.5ドル
(1)BITCOIN
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:38
移動した金額:3385808.5ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:6639850.5ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:2254813.8ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:551681.6ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:2886581ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:540399.44ドル
(1)BITCOIN
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:2220821.8ドル
(1)BITCOIN
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:00:38
移動した金額:1375365.9ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:43
移動した金額:527162.94ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:00:56
移動した金額:28307992ドル
(1)ETHEREUM
移動元:other ---> exchange:移動先
時刻:2021/02/28 12:01:19
移動した金額:9999985ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:01:54
移動した金額:7500000ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:01:54
移動した金額:1072806.5ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:02:27
移動した金額:501492.2ドル
(1)ETHEREUM
移動元:other ---> other:移動先
時刻:2021/02/28 12:02:33
移動した金額:1607318.4ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:02:33
移動した金額:996165.44ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:03:41
移動した金額:14284534ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:04:03
移動した金額:3018328.2ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:04:08
移動した金額:1534309.4ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:05:00
移動した金額:18639348ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:05:00
移動した金額:1524786.9ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:06:01
移動した金額:9999985ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:06:01
移動した金額:2706318.8ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:06:14
移動した金額:610771.5ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:06:42
移動した金額:996596.9ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:06:52
移動した金額:610766.9ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:06:52
移動した金額:4007327.2ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:07:13
移動した金額:500182.56ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:07:28
移動した金額:619302.44ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:08:00
移動した金額:995805.6ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:08:00
移動した金額:2402533ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:08:00
移動した金額:651634.94ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:09:10
移動した金額:1607318.4ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:10:48
移動した金額:2004882ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:11:25
移動した金額:4581423ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:11:46
移動した金額:709917ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:11:46
移動した金額:21297510ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:12:16
移動した金額:521376.88ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:12:33
移動した金額:869295.9ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:13:31
移動した金額:4299920ドル
(1)BINANCECHAIN
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:13:50
移動した金額:1368998.1ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:14:08
移動した金額:880493.06ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:14:26
移動した金額:6056354ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:15:07
移動した金額:733628.7ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:15:07
移動した金額:610208.75ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:15:07
移動した金額:1887425ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:15:10
移動した金額:567541ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:15:33
移動した金額:575419.75ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:16:05
移動した金額:5586878ドル
(1)ETHEREUM
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:16:05
移動した金額:514508.97ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:16:14
移動した金額:4234833ドル
(1)ETHEREUM
移動元:unknown ---> exchange:移動先
時刻:2021/02/28 12:17:48
移動した金額:853519.25ドル
(1)ETHEREUM
移動元:unknown ---> other:移動先
時刻:2021/02/28 12:17:48
移動した金額:20831368ドル
(1)ETHEREUM
移動元:exchange ---> unknown:移動先
時刻:2021/02/28 12:17:57
移動した金額:995763.44ドル
(1)ETHEREUM
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:18:11
移動した金額:570882.06ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:18:34
移動した金額:1012343ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:18:34
移動した金額:14800933ドル
(1)ETHEREUM
移動元:other ---> unknown:移動先
時刻:2021/02/28 12:18:34
移動した金額:21664986ドル
(1)BINANCECHAIN
移動元:exchange ---> exchange:移動先
時刻:2021/02/28 12:19:00
移動した金額:1743692.1ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:2171072ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:1042895.8ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:900095.8ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:854762ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:1132792.5ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:677747.94ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:1098161.9ドル
(1)BITCOIN
移動元:unknown ---> unknown:移動先
時刻:2021/02/28 12:19:14
移動した金額:1073471.9ドル

まとめ

個人で試しに利用するのであれば、無料で十分なのですが、取得できるデータが500,000ドル以上の部分が指定できないので、小さいものを検知できません。
時間があればクーロンを使って定期的に取得して表示までを試してみたい。

参考:Whale Alert公式サイトWhale Alert Twitter

スポンサード