日本語(JP)
English
アセットアナライザーAPIについて

アセットアナライザーAPIについて

graph
ブロックチェーンゲームインフォのアセットアナライザーでの機能を広く利用していただくべく、アセットアナライザーの一部データをAPIにて公開いたします。
ブログやデータ解析等にお役立てください。

概要

ブロックチェーンゲームインフォに掲載されているアセットデータを取得するAPIです。
各アセットの日毎のデータを、最高値・最安値・平均・取引回数・合計取引量取得することができます。
取得できるデータは、API実行時から過去30日分を返します。

対応アセット

マイクリプトヒーローズ
クリプトスペルズ
ブレイブフロンティアヒーローズ
エグリプト
コントラクトサーヴァント(サイト内マーケットのデータを反映)
等、アセットアナライザーに表示される全てのゲームに対応しています。
下記からアセットの一覧をご覧ください。
https://blockchaingame.jp/tokens

リクエスト方法

下記のURLへGETにてリクエストをするとアセット単体の日毎のデータを取得することが出来ます。

URL

GET https://api.blockchaingame.jp/api/v1/assets/{contract_address}/{token_id}?api_token={api_token}

GETパラメータ

必須
contract_address opensea で表示されている、contract_address (例:マイクリプトヒーローズのヒーローの場合、0x273f7f8e6489682df756151f5525576e322d51a3)
token_id opensea で表示されている、token_id (例: 50070001)
api_token 発行されたAPIキー
currency ETH,USD,JPY のどれかを1つを指定。デフォルトは、ETH

レスポンス

Json形式の日毎のアセットデータを返します。

コード 概要詳細
200 アセットデータ取得成功
404 パラメータ不正URLが正しいか確認してください
5xx サーバエラーが連続して発生する場合は、弊社担当までお問い合わせください

Json詳細

key value 詳細
result code 0: 成功1: 指定のリソースが存在しない2: 認証エラー
message 0: Success1: Not Found.2: Authentication error.
data list event_index: データの日付
high: 最高値
low: 最安値
average:平均
num:取引量
total:取引数
games_title ゲームのタイトル名
asset_name アセット名
asset_url BCGI内のアセットURL
currency 通貨の単位(ETH,USD,JPY)

レスポンス例

正常時

{
    "result": {
        "code": 0,
        "message": "success."
    },
    "data": {
        "list": [
            {
                "event_index": "2020-03-01",
                "high": 0.008,
                "low": 0.008,
                "average": 0.008,
                "num": "1",
                "total": 0.008
            },
            {
                "event_index": "2020-03-02",
                "high": null,
                "low": null,
                "average": null,
                "num": 0,
                "total": 0
            },
            ...
        ],
        "games_title: "F1 Delta Time",
        "asset_name": "Australia Edition 2020",
        "asset_url": "https://blockchaingame.jp/asset/8589"
        "currency: ETH"
    }
}

エラー時

{
    "result": {
        "code": 1,
        "message": "Not Found."
    },
    "data": {
    }
}

コントラクトアドレスの確認方法

ブロックチェーンゲームインフォのアセット個別ページの下部の共有データより確認が行えます。

アセットIDの確認方法

アセットのIDは、所有するアセットのIDを調べる方法や、
アセット個別ページの下部のアセット詳細部にサンプルIDを記載していますのでそちらを利用ください。

APIキーの申請方法

問い合わせページか、TwitterのDMよりお問い合わせください。
利用予定のメディア名と連絡先メールアドレスを記載ください。
問い合わせ
Twitter

グラフ出力JS有り

グラフ出力をそのまま埋め込む貼り付けコードも用意しております。
アセットページ下部のアセット貼り付けコードをご利用ください。

カスタマイズ

グラフ以外のデータが必要な際はお気軽にご相談ください。

クレジット

ご利用の際は、ウェブサイトのわかる場所へ、ブロックチェーンゲームインフォへのリンクの掲載をお願いいたします。
ロゴ画像:https://blockchaingame.jp/images/logo.png