1 of 3

Fungible token ownership

The FTOwnership entity represents a fungible token ownership relation between accounts and contract packages, as well as provides the corresponding token balances

Properties

The FTOwnership entity has the following properties:

Property

Type

Description

owner_hash

string(64)

Owner hash represented as a hexadecimal string. First part of token ownership identifier

contract_package_hash

string(64)

Fungible contract package hash represented as a hexadecimal string. Second part of token ownership identifier

balance

string

Fungible tokens balance in the network

Example

{
  "balance": "99999999999999999000",
  "contract_package_hash": "0e6a10012d734417ef6ff74e4a7881ad75bcbb3c455ccd63a677f7dd55f1f203",
  "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
}

Optional properties

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

Property

Type

Description

contract_package

Fungible contract package

Relations

Entity

Mapping property

Description

contract_package_hash

Fungible token ownership represents fungible contract package token owners

owner_hash

Account can be a token owner

Endpoints

The FTOwnership entity has the following endpoints:

Get contract package fungible token ownerships
Get account fungible token ownerships

Relation endpoints

None

Get account fungible token ownership

Get accounts fungible token ownership by identifier (public key or account hash)

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

Query params

None

Sorting

None

Optional properties

Property

Type

Description

contract_package

Fungible contract package

account_info

Owner account info

centralized_account_info

Owner centralized account info

Response

PaginatedResponse<FTOwnership>

Example

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

{
  "data": [
    {
      "balance": "999992019999999999690000000",
      "contract_package_hash": "000f00b1c6b691b47c1006730bd39812c598f4660e2420a5f5e2f9106865fed1",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    },
    {
      "balance": "99999999999999999000",
      "contract_package_hash": "018c20d50c52518b6d9c0390b1d2298e3638507d8fe9694d44b89b6af23c703d",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    },
    ...
    {
      "balance": "1000000000000000000000000000018415616000000000000000000",
      "contract_package_hash": "155e3d29b6eea4df9e2159c5e91cf325b94c3460224ea3c789dd70772a9048d6",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    }
  ],
  "item_count": 176,
  "page_count": 18
}

Get contract package fungible token ownership

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

Query params

None

Sorting

None

Optional properties

Property

Type

Description

contract_package

Fungible contract package

account_info

Owner account info

centralized_account_info

Owner centralized account info

Response

PaginatedResponse<FTOwnership>

Example

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

{
  "data": [
    {
      "balance": "999992019999999999690000000",
      "contract_package_hash": "000f00b1c6b691b47c1006730bd39812c598f4660e2420a5f5e2f9106865fed1",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    }
  ],
  "item_count": 1,
  "page_count": 1
}

Fungible token ownership

The FTOwnership entity represents a fungible token ownership relation between accounts and contract packages, as well as provides the corresponding token balances

Properties

The FTOwnership entity has the following properties:

Property

Type

Description

owner_hash

string(64)

Owner hash represented as a hexadecimal string. First part of token ownership identifier

contract_package_hash

string(64)

Fungible contract package hash represented as a hexadecimal string. Second part of token ownership identifier

balance

string

Fungible tokens balance in the network

Example

{
  "balance": "99999999999999999000",
  "contract_package_hash": "0e6a10012d734417ef6ff74e4a7881ad75bcbb3c455ccd63a677f7dd55f1f203",
  "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
}

Optional properties

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

Property

Type

Description

contract_package

Fungible contract package

Relations

Entity

Mapping property

Description

contract_package_hash

Fungible token ownership represents fungible contract package token owners

owner_hash

Account can be a token owner

Endpoints

The FTOwnership entity has the following endpoints:

Get contract package fungible token ownerships
Get account fungible token ownerships

Relation endpoints

None

Get contract package fungible token ownership

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

Query params

None

Sorting

None

Optional properties

Property

Type

Description

contract_package

Fungible contract package

account_info

Owner account info

centralized_account_info

Owner centralized account info

Response

PaginatedResponse<FTOwnership>

Example

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

{
  "data": [
    {
      "balance": "999992019999999999690000000",
      "contract_package_hash": "000f00b1c6b691b47c1006730bd39812c598f4660e2420a5f5e2f9106865fed1",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    }
  ],
  "item_count": 1,
  "page_count": 1
}

Get account fungible token ownership

Get accounts fungible token ownership by identifier (public key or account hash)

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

Query params

None

Sorting

None

Optional properties

Property

Type

Description

contract_package

Fungible contract package

account_info

Owner account info

centralized_account_info

Owner centralized account info

Response

PaginatedResponse<FTOwnership>

Example

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

{
  "data": [
    {
      "balance": "999992019999999999690000000",
      "contract_package_hash": "000f00b1c6b691b47c1006730bd39812c598f4660e2420a5f5e2f9106865fed1",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    },
    {
      "balance": "99999999999999999000",
      "contract_package_hash": "018c20d50c52518b6d9c0390b1d2298e3638507d8fe9694d44b89b6af23c703d",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    },
    ...
    {
      "balance": "1000000000000000000000000000018415616000000000000000000",
      "contract_package_hash": "155e3d29b6eea4df9e2159c5e91cf325b94c3460224ea3c789dd70772a9048d6",
      "owner_hash": "d0bc9ca1353597c4004b8f881b397a89c1779004f5e547e04b57c2e7967c6269"
    }
  ],
  "item_count": 176,
  "page_count": 18
}