This endpoint enables you to submit a background task. The task will refresh the metadata of a specified NFT asset.
API Endpoint
https://open-platform.nodereal.io/{apiKey}/nftscan
method_path:/api/v2/refresh/metadata/{chain_name}
method_type:POST
Request:
| Parameters | Descriptions | Query Type | Required | Data Type | schema |
|---|---|---|---|---|---|
| chain_name | Name of the chain you’re querying. List of supported values: "eth" for Ethereum; "bnb" for BNB Smart Chain; "polygon" for Polygon; "moonbeam" for Moonbeam; "arbitrum" for Arbitrum One; "optimism" for Optimism; "platon" for PlatON; "avalanche" for Avalanche; "cronos" for Cronos; "fantom" for Fantom; "gnosis" for Gnosis; | path | true | string | |
| MetadataTaskReq | MetadataTaskReq | body | true | MetadataTaskReq | MetadataTaskReq |
| contract_address | The contract address | true | string | ||
| token_id | The token ID | true | string |
Request Example:
{
"contract_address": "0x3e855b7941fe8ef5f07dad68c5140d6a3ec1b286",
"token_id": "0x000000000000000000000000000000000000000000000000000000000000013a"
}
Response:
| Parameters | Descriptions | Data Type | schema |
|---|---|---|---|
| code | Response status code (200 means the request was successful, 4XX or 5XX means the request failed) | integer(int32) | integer(int32) |
| data | Response data | TaskRetModel | TaskRetModel |
| reason | The reason for the FAIL status | string | |
| status | Task status. SUCCESS means the task was successfully submitted, FAIL means the task was not submitted due to some reason | string | |
| msg | Error message when request fails | string |
Example:
{
"code": 200,
"data": {
"reason": "task already exists",
"status": "SUCCESS"
},
"msg": ""
}