NFT

The nft API provide users the entries to interact with the NFTs.

Update NFT

Update NFT token uri

The Update NFT token uri API provides users to update the nft token uri according to the contract address and the token_id.

Update NFT token uri

put

http://api.nftrainbow.cnhttps://api.nftrainbow.cn

/v1/nft/{address}/{token_id}/tokenUri

Update NFT token uri

Authorizations

ApiKeyAuth

Path parameters

addressstringRequired

address

token_idstringRequired

token_id

Header parameters

AuthorizationstringRequired

Bearer Open_JWT

Body

application/json

chainstring · enumRequiredPossible values:

contract_typestring · enumRequiredPossible values:

token_uristringOptional

Responses

200

OK

application/json

block_reasonall ofOptional

没有发送到tx engine的原因，比如余额不足或网络错误等

integer · enumOptionalPossible values:

chainIdintegerOptional

chainTypeintegerOptional

created_atstringOptional

datastringOptional

epochHeightnumberOptional

epoch_numberintegerOptional

errorstringOptional

fromstringOptional

gasnumberOptional

gasCoveredBySponsorbooleanOptional

gasFeenumberOptional

gasPricenumberOptional

hashstringOptional

idintegerOptional

nonceintegerOptional

pending_reasonstringOptional

pre_hashsstringOptional

stageintegerOptional

stateinteger · enumOptionalPossible values:

statusintegerOptional

storageCollateralizednumberOptional

storageCoveredBySponsorbooleanOptional

storageLimitnumberOptional

taskTypeinteger · enumOptionalPossible values:

tostringOptional

tryReceiptCntintegerOptional

updated_atstringOptional

valuenumberOptional

400

Invalid request

application/json

put

/v1/nft/{address}/{token_id}/tokenUri

HTTPcURLJavaScriptPython

PUT /v1/nft/{address}/{token_id}/tokenUri HTTP/1.1
Host: api.nftrainbow.cn
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "chain": "conflux",
  "contract_type": "erc721",
  "token_uri": "text"
}

{
  "block_reason": 1,
  "chainId": 1,
  "chainType": 1,
  "created_at": "text",
  "data": "text",
  "deleted_at": {
    "time": "text",
    "valid": true
  },
  "epochHeight": 1,
  "epoch_number": 1,
  "error": "text",
  "from": "text",
  "gas": 1,
  "gasCoveredBySponsor": true,
  "gasFee": 1,
  "gasPrice": 1,
  "hash": "text",
  "id": 1,
  "nonce": 1,
  "pending_reason": "text",
  "pre_hashs": "text",
  "stage": 1,
  "state": -10,
  "status": 1,
  "storageCollateralized": 1,
  "storageCoveredBySponsor": true,
  "storageLimit": 1,
  "taskType": 1,
  "to": "text",
  "tryReceiptCnt": 1,
  "updated_at": "text",
  "value": 1
}

Auth

Name	Meaning	Param Type	Data Type
Authorization	Bearer Token	Header	string

Parameter

Response

Response Example

Requst Sample

Query NFT

Query specific NFT of specific account

The Query specific NFT of specific account API provides users to get the nft information according to the contract address and the token_id.

Get NFT info, mainly owner and metadata

get

http://api.nftrainbow.cnhttps://api.nftrainbow.cn

/v1/nft/{address}/{token_id}

Get NFT info, mainly owner and metadata

Authorizations

ApiKeyAuth

Path parameters

addressstringRequired

address

token_idstringRequired

token_id

Header parameters

AuthorizationstringRequired

Bearer Open_JWT

Responses

200

OK

application/json

contract_addressstringOptional

ownerstringOptional

token_idstringOptional

token_uristringOptional

400

Invalid request

application/json

500

Internal Server error

application/json

get

/v1/nft/{address}/{token_id}

HTTPcURLJavaScriptPython

GET /v1/nft/{address}/{token_id} HTTP/1.1
Host: api.nftrainbow.cn
Authorization: text
Accept: */*

{
  "contract_address": "text",
  "owner": "text",
  "token_id": "text",
  "token_uri": "text"
}

Auth

Name	Meaning	Param Type	Data Type
Authorization	Bearer Token	Header	string

Parameter

Response

Response Example

Requst Sample

The token_id is a number like "123", which type is string. If the type parameter pass erc1155, the response's owner field will be empty.

Query NFT Hold count