Query
Resync Token Metadata
Queue a resync task of token metadata.
In order to use Blockchain Data API you must first add the contract into your console with the contract name, deployed address, and ABI.
This will create a re(sync) event in order for you to query tokens (ERC20), NFTs (ERC720) or SFTs (ERC1155) depending on your contract.
Syncing your contract
1. Inside the console, select 'Contracts' within your created application and click 'Add an existing contract'.
2. Fill in the form with the contract name, deployed address, ABI and select which blockchain it is deployed on and click create.
You're done!
You can now use the Blockchain Data API to query NFT and token metadata, ownership data, transfer data and more.
Resyncing your contract
If your queries do not work or you have updated your contract in some way, you can resync the contract.
Queuing a contract for resyncing is slightly different depending on wether your contract is a token (ERC20), NFT (ERC721) or SFT (ERC1155).
Resync token metadata (ERC20)
Make a PUT request to tokens/resync. If the resync was successfully re-queued, then you will get a 200 response.
const response = await fetch('https://api.utiliti.ai/tokens/resync', { method: 'PUT', headers: { 'Content-Type': 'application/json', 'X-API-key': '<YOUR_API_KEY_HERE>', //replace }, body: JSON.stringify({ address: '<CONTRACT_ADDRESS>', //replace network: 5, // goerli token_ids: [ 1, 2, 3 ] }), })
SDK coming soon...
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT"); curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/tokens/resync"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "accept: application/json"); headers = curl_slist_append(headers, "content-type: application/json"); headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"address\":\"<CONTRACT_ADDRESS>\",\"network\":\"5\", \"token_ids:\":\"[ 1, 2, 3 ]\"}"); CURLcode ret = curl_easy_perform(hnd);
curl --request PUT \ --url hhttps://api.utiliti.ai/tokens/resync \ --header 'X-API-key: <YOUR_API_KEY_HERE>' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } '
$python -m pip install requests --- import requests url = "https://api.utiliti.ai/tokens/resync" payload = { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } headers = { "accept": "application/json", "content-type": "application/json", "X-API-key": "<YOUR_API_KEY_HERE>" } response = requests.put(url, json=payload, headers=headers) print(response.text)
Resync NFT metadata (ERC720)
Make a PUT request to nfts/resync. If the resync was successfully re-queued, then you will get a 200 response.
const response = await fetch('https://api.utiliti.ai/nfts/resync', { method: 'PUT', headers: { 'Content-Type': 'application/json', 'X-API-key': '<YOUR_API_KEY_HERE>', //replace }, body: JSON.stringify({ address: '<CONTRACT_ADDRESS>', //replace network: 5, // goerli token_ids: [ 1, 2, 3 ] }), })
SDK coming soon...
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT"); curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/nfts/resync"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "accept: application/json"); headers = curl_slist_append(headers, "content-type: application/json"); headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"address\":\"<CONTRACT_ADDRESS>\",\"network\":\"5\", \"token_ids:\":\"[ 1, 2, 3 ]\"}"); CURLcode ret = curl_easy_perform(hnd);
curl --request PUT \ --url hhttps://api.utiliti.ai/nfts/resync \ --header 'X-API-key: <YOUR_API_KEY_HERE>' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } '
$python -m pip install requests --- import requests url = "https://api.utiliti.ai/nfts/resync" payload = { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } headers = { "accept": "application/json", "content-type": "application/json", "X-API-key": "<YOUR_API_KEY_HERE>" } response = requests.put(url, json=payload, headers=headers) print(response.text)
Resync SFT metadata (ERC1155)
Make a PUT request to sfts/resync. If the resync was successfully re-queued, then you will get a 200 response.
const response = await fetch('https://api.utiliti.ai/sfts/resync', { method: 'PUT', headers: { 'Content-Type': 'application/json', 'X-API-key': '<YOUR_API_KEY_HERE>', //replace }, body: JSON.stringify({ address: '<CONTRACT_ADDRESS>', //replace network: 5, // goerli token_ids: [ 1, 2, 3 ] }), })
SDK coming soon...
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT"); curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/sfts/resync"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "accept: application/json"); headers = curl_slist_append(headers, "content-type: application/json"); headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"address\":\"<CONTRACT_ADDRESS>\",\"network\":\"5\", \"token_ids:\":\"[ 1, 2, 3 ]\"}"); CURLcode ret = curl_easy_perform(hnd);
curl --request PUT \ --url hhttps://api.utiliti.ai/sfts/resync \ --header 'X-API-key: <YOUR_API_KEY_HERE>' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } '
$python -m pip install requests --- import requests url = "https://api.utiliti.ai/sfts/resync" payload = { "address": "<CONTRACT_ADDRESS>", "network": 5, "token_ids": [1, 2, 3] } headers = { "accept": "application/json", "content-type": "application/json", "X-API-key": "<YOUR_API_KEY_HERE>" } response = requests.put(url, json=payload, headers=headers) print(response.text)