Get Token Ownership History

Returns the transaction history of a specified token from the time it was minted. Each item in the response represents a transfer.

Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

Contract address (in hex.) or alias.

token-id
required
string

Token ID

query Parameters
size
integer <int64>

The number of items to return (min=1, max=1000, default=100).

cursor
string

The pointer for the next request, after which the result will be returned.

Example: cursor=eyJjm...ZSJ9
header Parameters
x-chain-id
required
string

Kaia Network Chain ID (1001 or 8217)

Responses
200

Your request was successful.

400

Your request is not valid.

401

The credential you entered is invalid.

404

The resource you requested does not exist.

get/v2/contract/{contract-address-or-alias}/token/{token-id}/history
Request samples
curl -i -X GET \
  -u <username>:<password> \
  'https://kip17-api.klaytnapi.com/v2/contract/{contract-address-or-alias}/token/{token-id}/history?size=0&cursor=string' \
  -H 'x-chain-id: string'
Response samples
application/json

Your request was successful.

{
  • "cursor": "eyJjm...ZSJ9",
  • "items": [
    ]
}