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

Example

Optional properties

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

Property

Type

Description

Relations

Endpoints

The NFTTokenOwnership entity has the following endpoints:

Relation endpoints

None

Get contract package NFT ownership

Get contract package NFT ownerships

GET /contract-packages/{contract_package_hash}/nft-token-ownership

Query params

Query param

Description

owner_hash

Owner hash

Sorting

Property

Description

tokens_number

Sort NFT token ownership by tokens number

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

contract_package

Fungible 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

Response

PaginatedResponse<NFTTokenOwnership>

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

Get account NFT ownership

Get account NFT ownerships

GET /accounts/{account_identifier}/nft-token-ownership

Query params

Query param

Description

contract_package_hash

Contract package hash

Sorting

Property

Description

tokens_number

Sort NFT token ownership by tokens number

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

contract_package

Fungible 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

Response

PaginatedResponse<NFTTokenOwnership>

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 account NFT ownership

Get account NFT ownerships

GET /accounts/{account_identifier}/nft-token-ownership

Query params

Query param

Description

contract_package_hash

Contract package hash

Sorting

Property

Description

tokens_number

Sort NFT token ownership by tokens number

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

contract_package

Fungible 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

Response

PaginatedResponse<NFTTokenOwnership>

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

GET /contract-packages/{contract_package_hash}/nft-token-ownership

Query params

Query param

Description

owner_hash

Owner hash

Sorting

Property

Description

tokens_number

Sort NFT token ownership by tokens number

Default sorting is tokens_number DESC

Optional properties

Property

Type

Description

contract_package

Fungible 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

Response

PaginatedResponse<NFTTokenOwnership>

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