NFTPLUSのAPIについて

NFTPLUS 各種APIについての説明となります。

NFTPLUSのAPIは非商用の場合、どなたでもご利用いただけます。商用の場合はご連絡くださいませ。 なお、非商用による不具合等により生じたいかなる損害に関しまして当社は一切責任を負いません。また予告なくAPIやサービスを変更、停止する場合がありますこと、ご了承ください。

以下が各種APIとなります。

Approval API

proxyIsApprovalForAll

GET https://api.mch.plus/approval/:network/:assetContract/:owner/:operator

isApproval状態を確認するAPIです

Path Parameters

Headers

200: OK true/falseで返します。

boolean

Block API

Get Latest Block

GET https://api.mch.plus/block/:network/latest

最新ブロックナンバーを取得

Path Parameters

Headers

200: OK

{    "name": "Cake's name",    "recipe": "Cake's recipe name",    "cake": "Binary cake"}

404: Not Found

{    "message": "Ain't no cake like that."}

get time

GET /block/:network/time/:num

ブロックナンバーのtimestampを取得

Path Parameters

Headers

200: OK

1

gas API

Get Suggested Gas Price

GET https://api.mch.plus/gas/:network/suggested-price

Gas priceの取得

Path Parameters

Headers

200: OK Cake successfully retrieved.

210000000000

Inventory API

Get Assets

GET https://api.mch.plusinventory/:network/:owner/:assetContract

wner addressのコントラクトアドレス毎のインベントリを取得

Path Parameters

Headers

200: OK Cake successfully retrieved.

{"contract":"0x273f7f8e6489682df756151f5525576e322d51a3","id":20400214,"owner":"0xa8141206b6b9d122f0bff10e1641e173a672e29d"}

Get Contracts

GET https://api.mch.plus inventory/:network/:owner

owner addressが持つアセットのコントラクトアドレスを取得

Path Parameters

Headers

200: OK

["0xdceaf1652a131f32a821468dc03a92df0edd86ea"]

Owner of API

Owner of

GET https://api.mch.plus/:network/:assetContract/:id

アセットidからOwnerを取得します

Path Parameters

200: OK Cake successfully retrieved.

{0xa8141206B6b9d122f0bFf10e1641e173A672e29D

Metadata API

• Ethereum NFT metadata

Get Multiple NFT Metadata

GET https://api.mch.plus/metadata/ethereum/mainnet/:address/:id

指定したNFTのMetadataを取得できます。

Path Parameters

Query Parameters

Headers

200: OK Metadata JSON successfully retrieved.

{
  "0x51C36baAa8b0e6CF45e2E1A77E84E3c0D1713F97": {
    "name": "Awesome asset",
    "description": "Great"
  }
}

404: Not Found Could not find a metadata matching this query.

{
    "message": "Not found"
}

Get NFT Metadata

GET https://api.mch.plus/metadata/mainnet/:address/:id?iss=:issuer

発行者を指定してNFT Metadataを取得できます。

Path Parameters

Query Parameters

Headers

200: OK

{
  "name": "Awesome asset",
  "description": "Great"
}

Post NFT Metadata

POST https://api.mch.plus/metadata/mainnet/:address/:id

You can post new metadata with issuer and signature.

Path Parameters

Headers

Request Body

200: OK

{ {
    "iss": "0xd868711BD9a2C6F1548F5f4737f71DA67d821090", 
    "sig": "0x01234567890abcdef", 
    "metadata": "ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K"
}  }  

404: Not Found

$ echo -n ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K \
| base64 -d
{
    "name": "Awesome asset",
    "description": "Great"
}

入力データには、署名した発行者(iss)、EIP-191: Signed Data Standard形式で署名した署名(sig)、Base64でエンコードしたmetadataを含ませる必要があります。

sample body

{ {
    "iss": "0xd868711BD9a2C6F1548F5f4737f71DA67d821090", 
    "sig": "0x01234567890abcdef", 
    "metadata": "ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K"
}  }  

$ echo -n ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K \
| base64 -d
{
    "name": "Awesome asset",
    "description": "Great"
}

• Ethereum account metadata

Get Multiple Account Metadata

GET https://api.mch.plus/metadata/ethereum/mainnet/:address

指定したアドレスにあるMetadataを全て取得します

Path Parameters

Query Parameters

Headers

200: OK

{
  "0x51C36baAa8b0e6CF45e2E1A77E84E3c0D1713F97": {
    "name": "Awesome asset",
    "description": "Great"
  }
}

400: Bad Request

{
    "message": "Not found"
}

Get Account Metadata

GET https://api.mch.plus/metadata/ethereum/mainnet/:address?iss=:issuer

発行者を指定してMetadataを取得できます。

Path Parameters

Query Parameters

Headers

200: OK

{
  "name": "Awesome asset",
  "description": "Great"
}

404: Not Found

{
    "message": "Not found"
}

Post Account Metadata

POST https://beta-api.mch.plus/metadata/ethereum/mainnet/:address

アカウントにMetadataを登録できます。登録にはEOAアカウントによる署名が必要です。

Path Parameters

Headers

Request Body

200: OK

"ok"

入力データには、署名した発行者(iss)、EIP-191: Signed Data Standard形式で署名した署名(sig)、Base64でエンコードしたmetadataを含ませる必要があります。

{ 
    "iss": "0xd868711BD9a2C6F1548F5f4737f71DA67d821090", 
    "sig": "0x01234567890abcdef", 
    "metadata": "ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K"
}   

$ echo -n ewogICAgIm5hbWUiOiAiQXdlc29tZSBhc3NldCIsCiAgICAiZGVzY3JpcHRpb24iOiAiR3JlYXQiCn0K \
| base64 -d
{
    "name": "Awesome asset",
    "description": "Great"
}

ERC 721 Converter Contract

NFT Converterコントラクトを提供いたします。 開発者は2つのNFTコントラクトAliceとBobで対となるTokenIDを登録します。 利用者は、このコントラクトにトランザクションを発行することで、Alice NFTからBob NFTへのアセット交換が行われます。

ただいま、Smart Contractのソースコードを公開準備中です。

詳しくはお問い合わせまでご相談ください。