Nft API

Get contract's mint NFT transfers

Request

• method: POST

• url: /eth/nft/{contract}/mints

• path:

Name	Type	Description	Example
contract	string	The contract address which generates these transfers.	0x0c600d41b9c7656e60c0bf76d79b1532b4770d0c

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Array<NftTransfer>

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."
    }
  }
]

Get amount of contract's mint NFT transfers

Request

• method: POST

• url: /eth/nft/{contract}/mints/count

• path:

Name	Type	Description	Example
contract	string	The contract address which generates these transfers.	0x0c600d41b9c7656e60c0bf76d79b1532b4770d0c

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Name	Type	Description
count	number	The count of items.

Example

{
  "count": 0
}

Get all NFT transfers

Request

• method: POST

• url: /eth/nft/{contract}/transfers

• path:

Name	Type	Description	Example
contract	string	The contract address which generates these transfers.	0x0c600d41b9c7656e60c0bf76d79b1532b4770d0c

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Array<NftTransfer>

Example

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

Get amount of NFT transfers

Request

• method: POST

• url: /eth/nft/{contract}/transfers/count

• path:

Name	Type	Description	Example
contract	string	The contract address which generates these transfers.	0x0c600d41b9c7656e60c0bf76d79b1532b4770d0c

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Name	Type	Description
count	number	The count of items.

Example

{
  "count": 0
}

Get all NFT tokens

Request

• method: POST

• url: /eth/nft/{contract}/tokens

• path:

Name	Type	Description	Example
contract	string	The ERC721 address.	0x57e9a39ae8ec404c08f88740a9e6e306f50c937f

• query:

Name	Type	Description	Example
address	string	The token's owner address.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba
withMetadata	boolean	With metadata when true, or without metadata when false.	false

Response

Data Type

Array<NftToken>

Example

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

Get all mint NFT transfers

Request

• method: POST

• url: /eth/nft/mints

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Array<NftTransfer>

Example

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

Get amount of mint NFT transfers

Request

• method: POST

• url: /eth/nft/mints/count

• query:

Name	Type	Description	Example
txhash	string	The hash of the transaction which generates these transfers.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
to	string	The token's new owner.	0xf2587224b6efec80a81076c0a5a282fd21d3c8ba

Response

Data Type

Name	Type	Description
count	number	The count of items.

Example

{
  "count": 0
}

Get token's metadata in the contract

Request

• method: GET

• url: /eth/nft/{contract}/metadata/{tokenId}

• path:

Name	Type	Description	Example
contract	string	The ERC721 address.	0xdd07d272cb04fa80bebe498e30bc4f6c7f6789aee73e0ba7a579213e3e5eddaa
tokenId	string	The token id.	4679

Response

Date Type

Array<NftMetadata>

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"
    }
  ]
}

Sign data

Request

• method: POST

• url: /eth/nft/claims/sign

• body

Date Type

Name	Type	Description
name	string	The user readable name of signing domain, i.e. the name of the DApp or the protocol.
version	string	The current major version of the signing domain. Signatures from different versions are not compatible.
chainId	number	The EIP-155 chain id. The user-agent should refuse signing if it does not match the currently active chain.
verifyingContract	string	The address of the contract that will verify the signature. The user-agent may do contract specific phishing prevention.
recipient	string	The recipient address who can claim.
nonce	number	The nonce value.

Example

{
  "name": "Creature",
  "version": "1.0.0",
  "chainId": 80001,
  "verifyingContract": "0x7ff0c96136cdb30ba9cec487db81de356f58de81",
  "recipient": "0x8899b50613ab56f4d21ff5407d3f16adf5fce884",
  "nonce": 1
}

Response

Date Type

Name	Type	Description
name	string	The user readable name of signing domain, i.e. the name of the DApp or the protocol.
version	string	The current major version of the signing domain. Signatures from different versions are not compatible.
chainId	number	The EIP-155 chain id. The user-agent should refuse signing if it does not match the currently active chain.
verifyingContract	string	The address of the contract that will verify the signature. The user-agent may do contract specific phishing prevention.
recipient	string	The recipient address who can claim.
amount	number	The nft amount which the recipient will receive.
nonce	number	The nonce value.
signature	string	The signature.

Example

{
  "name": "Creature",
  "version": "1.0.0",
  "chainId": 80001,
  "verifyingContract": "0x7ff0c96136cdb30ba9cec487db81de356f58de81",
  "recipient": "0x8899b50613ab56f4d21ff5407d3f16adf5fce884",
  "amount": 1,
  "nonce": 1,
  "signature": "0xfe6cdbf34c2f0beda3bdc3f23932bc3ede8d9e1a4f1ed3d4b6d7333e9e8c23bb08f2925c5b5a26f9b987acdb0a361520568fe9a7fcecde9a9a89cc98346c926a1c"
}