1 of 3

Non-fungible token (NFT) ownership

The NFTTokenOwnership entity represents a NFT ownership relation between accounts and contract packages, as well as provides the total tokens number.

Properties

The NFTTokenOwnership entity has the following properties:

Property

Type

Description

owner_hash

string(64)

Owner hash represented as a hexadecimal string

contract_package_hash

string(64)

NFT contract package hash represented as a hexadecimal string

owner_type

uint8

NFT token owner type: 0 for account, 1 for contract

tokens_number

uint32

Number of NFTs owned by the owner account

Example

{
  "contract_package_hash": "0074557b46c7a7c13e0b178e4463f451325129d845e9e494425d39cfd40e619d",
  "owner_hash": "532402a902ee117a772b2471df237346c906eddeb1580e18fa8b71ea559b9d2f",
  "owner_type": 0,
  "tokens_number": 1
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the NFTTokenOwnership entity:

Property

Type

Description

contract_package

NFT contract package

owner_public_key

string(68)

Owner public key if it's an account

account_info

Owner account info

centralized_account_info

Owner centralized account info

cspr_name

string

Owner account CSPR.name

Relations

Entity

Mapping property

Description

contract_package_hash

NFT token ownership represents NFT contract package token owners

owner_hash

Account can be a token owner

Endpoints

The NFTTokenOwnership entity has the following endpoints:

Get contract package NFT ownerships
Get account NFT ownerships

Relation endpoints

None

Get contract package NFT ownership

Get contract package NFT ownerships

Query params

Query param

Description

Sorting

Property

Description

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

Response

Example

Get account NFT ownership

Get account NFT ownerships

Query params

Query param

Description

Sorting

Property

Description

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

Response

Example

Non-fungible token (NFT) ownership

The NFTTokenOwnership entity represents a NFT ownership relation between accounts and contract packages, as well as provides the total tokens number.

Properties

The NFTTokenOwnership entity has the following properties:

Property

Type

Description

owner_hash

string(64)

Owner hash represented as a hexadecimal string

contract_package_hash

string(64)

NFT contract package hash represented as a hexadecimal string

owner_type

uint8

NFT token owner type: 0 for account, 1 for contract

tokens_number

uint32

Number of NFTs owned by the owner account

Example

{
  "contract_package_hash": "0074557b46c7a7c13e0b178e4463f451325129d845e9e494425d39cfd40e619d",
  "owner_hash": "532402a902ee117a772b2471df237346c906eddeb1580e18fa8b71ea559b9d2f",
  "owner_type": 0,
  "tokens_number": 1
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the NFTTokenOwnership entity:

Property

Type

Description

contract_package

NFT contract package

owner_public_key

string(68)

Owner public key if it's an account

account_info

Owner account info

centralized_account_info

Owner centralized account info

cspr_name

string

Owner account CSPR.name

Relations

Entity

Mapping property

Description

contract_package_hash

NFT token ownership represents NFT contract package token owners

owner_hash

Account can be a token owner

Endpoints

The NFTTokenOwnership entity has the following endpoints:

Get contract package NFT ownerships
Get account NFT ownerships

Relation endpoints

None

Get account NFT ownership

Get account NFT ownerships

Query params

Query param

Description

Sorting

Property

Description

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

Response

Example

curl -X 'GET' \
  'https://api.testnet.cspr.cloud/accounts/1de39471ba0a9e8fa627a27fb01f261dc73ca8f8942c01982c03c4c73a193893/nft-token-ownership' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'

{
  "data": [
    {
      "contract_package_hash": "00530561446e9ca68b04b2bfbb3fc9cfad9e444340c954b970fbd524ff3c25ee",
      "owner_hash": "1de39471ba0a9e8fa627a27fb01f261dc73ca8f8942c01982c03c4c73a193893",
      "owner_type": 0,
      "tokens_number": 1
    },
    {
      "contract_package_hash": "998af6825d77da15485baf4bb89aeef3f1dfb4a78841d149574b0be694ce4821",
      "owner_hash": "1de39471ba0a9e8fa627a27fb01f261dc73ca8f8942c01982c03c4c73a193893",
      "owner_type": 0,
      "tokens_number": 1
    }
  ]
}

Get contract package NFT ownership

Get contract package NFT ownerships

Query params

Query param

Description

Sorting

Property

Description

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

Response

Example

curl -X 'GET' \
  'https://api.testnet.cspr.cloud/contract-packages/000f00b1c6b691b47c1006730bd39812c598f4660e2420a5f5e2f9106865fed1/nft-token-ownership' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'

{
  "data": [
    {
      "contract_package_hash": "0074557b46c7a7c13e0b178e4463f451325129d845e9e494425d39cfd40e619d",
      "owner_hash": "532402a902ee117a772b2471df237346c906eddeb1580e18fa8b71ea559b9d2f",
      "owner_type": 0,
      "tokens_number": 1
    },
    {
      "contract_package_hash": "0074557b46c7a7c13e0b178e4463f451325129d845e9e494425d39cfd40e619d",
      "owner_hash": "d619411005c1255ca0cfdc9121d0e0a60d2b4e8da354e4d8768e8ea9378635d6",
      "owner_type": 0,
      "tokens_number": 2
    },
    {
      "contract_package_hash": "0074557b46c7a7c13e0b178e4463f451325129d845e9e494425d39cfd40e619d",
      "owner_hash": "e92b24043adab658450b1a00a82f4ae6dcba196972081175317dff1702e3772b",
      "owner_type": 0,
      "tokens_number": 2
    }
  ]
}