Get NFT Provenance

GET 
/public/NftProvenance

Operation GetNftProvenance returns history of NFT ownership for a particular nft ID.

Request

Query Parameters

currency string

Fiat currency used for converting crypto prices

nft_id stringrequired
page uint16

Possible values: >= 1 and <= 65536

Default value: 1

Page number with query results starting from one

per_page uint16

Possible values: >= 1 and <= 1000

Default value: 5

Responses

200

Response

application/json

Schema

Schema

error string[]required
result objectnullable
items object[]required
Array [
amount objectnullable
For how much (if known)
fiat objectnullable
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
native objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
blockchain stringrequired
Possible values: [Ethereum, Solana, Polygon]
On what blockchain did the event happen
count uint64required
How many tokens (for SFTs may be > 1)
from stringrequired
Previous owner of the token
kind stringrequired
Possible values: [mint, transfer, burn, sale]
Type of the provenance record.
nft_id stringrequired
ID of the NFT that this record relates to.
to stringrequired
New owner of the token
txid stringrequired
Opaque identifier of the transaction on blockchain (Can be used for blockchain explorer)
when int64required
When the transaction happened (seconds since epoch)
]
total uint64required

Example (from schema)

{
  "error": [
    "EGeneral:Invalid arguments"
  ],
  "result": {
    "items": [
      {
        "amount": {
          "fiat": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "native": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        },
        "blockchain": "Ethereum",
        "count": 0,
        "from": "string",
        "kind": "mint",
        "nft_id": "string",
        "to": "string",
        "txid": "string",
        "when": 0
      }
    ],
    "total": 0
  }
}

Example

{
  "error": [],
  "result": {
    "items": [
      {
        "kind": "sale",
        "nft_id": "NT7EYX2-D7QVC-S7JDLE",
        "blockchain": "Ethereum",
        "from": "0xaeb3fea566c8bcb7ae6826a03f818d9d386169ba",
        "to": "0xdc5dc5b18f09cdf1ae14862e8e4665369e614ce7",
        "count": 1,
        "when": 1658139300,
        "txid": "0x1fced7290921922e6b1f2b1566e71968d31549b3762740d03a1ed443a8ef2762",
        "amount": {
          "native": {
            "asset_name": "ETH",
            "asset_alt_name": "ETH",
            "amount": "0.0100000000"
          },
          "fiat": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "25.2324"
          }
        }
      },
      {
        "kind": "mint",
        "nft_id": "NT7EYX2-D7QVC-S7JDLE",
        "blockchain": "Ethereum",
        "from": "0x0000000000000000000000000000000000000000",
        "to": "0xaeb3fea566c8bcb7ae6826a03f818d9d386169ba",
        "count": 1,
        "when": 1639091332,
        "txid": "0xf8db308e1f0c5a7dfe75b78a0b8d1090a61e05de1c89a7e287f65687e61e7f32",
        "amount": null
      }
    ],
    "total": 2
  }
}

Loading...