NFT Ownerships

Get NFT Ownership by Id

Returns Ownership by Id

SecurityApiKeyAuth
Request
path Parameters
ownershipId
required
string (OwnershipId)

Ownership Id in format: 'ETHEREUM:${token}:${tokenId}:${owner}'

Example: ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb
Responses
200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

get/v0.1/ownerships/{ownershipId}
Response samples
application/json
{
  • "id": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb",
  • "blockchain": "ETHEREUM",
  • "itemId": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410",
  • "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430",
  • "collection": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8",
  • "tokenId": 123456,
  • "owner": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
  • "value": 123456,
  • "source": "MINT",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "lastUpdatedAt": "2019-08-24T14:15:22Z",
  • "creators": [ ],
  • "lazyValue": 123456,
  • "pending": [ ],
  • "bestSellOrder": {
    },
  • "originOrders": [
    ]
}

Get NFT Ownerships by Ids

Returns Ownerships by specified list of Ids

SecurityApiKeyAuth
Request
Request Body schema: application/json
required
ids
required
Array of strings (OwnershipId)

List of the Ownerships ids

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/v0.1/ownerships/byIds
Request samples
application/json
{
  • "ids": [
    ]
}
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}

Get NFT Collection's Ownerships

Returns list of NFTs Ownerships from specified collection and sorted by last updated date

SecurityApiKeyAuth
Request
query Parameters
collection
required
string (ContractAddress)

Address of the collection

Example: collection=ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430
continuation
string

Continuation token from the previous response

size
integer

The number of items to return

Responses
200

OK

400

Bad Request

500

Internal Server Error

get/v0.1/ownerships/byCollection
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}

Get NFTs Ownerships

Returns list of NFTs Ownerships for specified NFT and sorted by last updated date

SecurityApiKeyAuth
Request
query Parameters
itemId
required
string (ItemId)

Item Id, has format ETHEREUM:${token}:${tokenId}

Example: itemId=ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410
continuation
string

Continuation token from the previous response

size
integer

The number of items to return

Responses
200

OK

400

Bad Request

500

Internal Server Error

get/v0.1/ownerships/byItem
Response samples
application/json
{
  • "total": 0,
  • "continuation": "string",
  • "ownerships": [ ]
}

Get collections owned items by owner

Returns list of collection with owned items by specified owner

SecurityApiKeyAuth
Request
query Parameters
owners
required
Array of strings (UnionAddress)

Addresses of the owner

Example: owners=ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb
blockchains
Array of strings (Blockchain)

Since user's address can be present in several blockchains (for example, ETHEREUM and POLYGON), you can use this filter to get Orders only for specific blockchains. Or keep it empty to get Order from all blockchains

Items Enum: "APTOS" "ETHEREUM" "POLYGON" "FLOW" "TEZOS" "SOLANA" "IMMUTABLEX" "MANTLE" "ARBITRUM" "CHILIZ" "LIGHTLINK" "ZKSYNC" "ASTARZKEVM" "BASE" "RARI" "CELO" "FIEF" "XAI" "KROMA" "ZKLINK" "OASYS" "QUAI" "ECLIPSE" "SAAKURU" "OASIS" "PALM" "MATCH" "FIVIRE" "SEI" "CAMP" "LISK" "MOONBEAM" "ETHERLINK" "ZKCANDY"
Example: blockchains=ETHEREUM
continuation
string

Continuation token from the previous response

size
integer

The number of items to return

Responses
200

OK

400

Bad Request

500

Internal Server Error

get/v0.1/ownerships/collections
Response samples
application/json
{
  • "collections": [
    ],
  • "continuation": "string"
}
➔ Next to NFT Sales