Nft Schemas

NftTransfer

Data Type

Name	Type	Description
timestamp	number	The timestamp at which the transfer is emitted.
blockNumber	number	The block number in which the transfer was emitted.
transactionHash	string	The hash of the transaction which generates this transfer.
logIndex	number	The log index in the transaction.
address	string	The contract address which generates this transfer.
from	string	The token's current owner.
to	string	The token's new owner.
tokenId	string	The token id to transfer.
metadata	NftSummary	The token's metadata.

Example

{
  "timestamp": 1646717593,
  "blockNumber": 32854079,
  "transactionHash": "0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa",
  "logIndex": 62,
  "address": "0x0c600d41b9c7656e60c0bf76d79b1532b4770d0c",
  "from": "0x5d60bee35e9d71b1012295f7dc4e0fbc0d7097c5",
  "to": "0xf2587224b6efec80a81076c0a5a282fd21d3c8ba",
  "tokenId": "4679",
  "metadata": {
    "name": "Compact Taxi",
    "image": "https://polkacity.app/assetimage/1001",
    "external_url": "https://polkacity.app/assetimage/1001",
    "description": "This Polka City Compact Taxi pays 60 POLC tokens every week to NFT holder."
  }
}

NftToken

Data Type

Name	Type	Description
timestamp	number	The timestamp of balance changed.
blockNumber	number	The block number in which the transfer was emitted.
address	string	The owner address of this token.
contract	string	The ERC721 address.
token_id	string	The token id.
token_uri	string	The token's metadata URI.

Example

{
  "timestamp": 1646708400,
  "blockNumber": 32849988,
  "address": "0xf2587224b6efec80a81076c0a5a282fd21d3c8ba",
  "contract": "0x57e9a39ae8ec404c08f88740a9e6e306f50c937f",
  "token_id": "4679",
  "token_uri": "https://polkacity.app/nftassets/1001"
}

NftSummary

Data Type

Name	Type	Description
name	string	The token's name.
image	string	The token's image URL.
external_url	string	The image URL on OpenSea.
description	string	The token's description.

Example

{
  "name": "Compact Taxi",
  "image": "https://polkacity.app/assetimage/1001",
  "external_url": "https://polkacity.app/assetimage/1001",
  "description": "This Polka City Compact Taxi pays 60 POLC tokens every week to NFT holder."
}

NftMetadata

Date Type

Name	Type	Description
contract	string	The ERC721 address.
token_id	string	The token id.
external_url	string	The image URL on OpenSea.
youtube_url	string	The image URL on Youtube.
description	string	The token's description.
background_color	string	The token's background color on OpenSea. Must be a six-character hexadecimal without a pre-pended #.
image	string	The token's image URL.
image_data	string	Raw SVG image data, if you want to generate images on the fly (not recommended).
animation_url	string	A URL to a multi-media attachment for the token.
name	string	The token's name.
attributes	object	The token's properties displayed on the OpenSea page.
-trait_type	string	The trait name.
-value	any	The trait's value
-display_type	string	The trait's display type.

Example

{
  "contract": "0x57e9a39ae8ec404c08f88740a9e6e306f50c937f",
  "token_id": "4679",
  "external_url": "https://storage.googleapis.com/opensea-prod.appspot.com/puffs/2.png",
  "youtube_url": "https://storage.googleapis.com/opensea-prod.appspot.com/puffs/3.png",
  "description": "This Polka City Compact Taxi pays 60 POLC tokens every week to NFT holder.",
  "background_color": "E6E6E6",
  "image": "https://storage.googleapis.com/opensea-prod.appspot.com/puffs/4.png",
  "image_data": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?><!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\" \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\"><svg version=\"1.1\" id=\"Layer_1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" x=\"0px\" y=\"0px\" width=\"128px\" height=\"128px\" viewBox=\"0 0 128 128\" enable-background=\"new 0 0 128 128\" xml:space=\"preserve\">  <image id=\"image0\" width=\"128\" height=\"128\" x=\"0\" y=\"0\" href=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACAAgMAAAC+UIlYAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAADFBMVEXMWG1BqjTtkdv///+fPGKRAAAAAWJLR0QDEQxM8gAAAAd0SU1FB+YDCAwTBZZCTHkAAABZSURBVFjD7dXBDQAgCANAlmRJpxSMECE4QdsX1vNHoohFLcsiNz57F2cCLBBomgnwgH5CgAemF6UjgALxkWiLd+eOAAr0oj8gwAK5GC2lI4ACuRhPSkeAAjYQ4HyuTir61AAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAyMi0wMy0wOFQxMjoxOTowNSswMDowMGB5OQQAAAAldEVYdGRhdGU6bW9kaWZ5ADIwMjItMDMtMDhUMTI6MTk6MDUrMDA6MDARJIG4AAAAAElFTkSuQmCC\" /></svg>",
  "animation_url": "https://rr4---sn-ogul7n7z.googlevideo.com/videoplayback?expire=1646764134&ei=BkwnYuX_G9eIkgaklZLYCw&ip=44.234.40.49&id=o-AOd1dTH7z0Qo0dP6Lh6ZyX-JtzGK7s7c68-C5g6-2Crd&itag=135&aitags=133%2C134%2C135%2C136%2C160%2C242%2C243%2C244%2C247%2C278%2C298%2C299%2C302%2C303%2C308%2C315%2C394%2C395%2C396%2C397%2C398%2C399%2C400%2C401&source=youtube&requiressl=yes&vprv=1&mime=video%2Fmp4&ns=OGNrSG6S91zvgCImVgLReboG&gir=yes&clen=1418421&dur=358.999&lmt=1641739040884936&keepalive=yes&fexp=24001373,24007246,24162928&c=WEB&txp=4532434&n=9ygiGIA2pJj8LuP1f4Jp&sparams=expire%2Cei%2Cip%2Cid%2Caitags%2Csource%2Crequiressl%2Cvprv%2Cmime%2Cns%2Cgir%2Cclen%2Cdur%2Clmt&sig=AOq0QJ8wRAIgbYDYFI44IvhhkoIFT0KXuUu7oOn7mgx0_OFv9NC1J-oCIFGM4S0vwG_SnHuuexGWukzyMQg9GtpAU1kPC00F3iAP&rm=sn-nx5ze7z&req_id=29cc321b7862a3ee&ipbypass=yes&redirect_counter=2&cm2rm=sn-ouu2j-ioqz7z&cms_redirect=yes&cmsv=e&mh=es&mip=164.70.90.41&mm=29&mn=sn-ogul7n7z&ms=rdu&mt=1646742339&mv=m&mvi=4&pl=22&lsparams=ipbypass,mh,mip,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRgIhAOixRweG18rKMarFNtEfeyZcdLPpSCUan4DTok6IqDZaAiEAl2fYsqwcHB5Io5GrNnKFPNdwi_ekCMk_bUNV993WgqY%3D",
  "name": "Compact Taxi",
  "attributes": [
    {
      "trait_type": "Aqua Power",
      "value": 40,
      "display_type": "boost_number"
    }
  ]
}