Sign in

v1

latestOpenAPI 3.0.3raw.githubusercontent.com2025-06-1883262329.3 KB
NFT Ownerships

Get NFT Ownership by Id

Returns Ownership by Id

get/v0.1/ownerships/{ownershipId}

Path parameters

ownershipIdstring required
Example:ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb

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

Response

OK

idstring required
blockchain'APTOS' | 'ETHEREUM' | 'POLYGON' | 'FLOW' | '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' | 'ALEPHZERO' | 'BERACHAIN' | 'ABSTRACT' | 'SHAPE' | 'TELOS' | 'HEDERAEVM' | 'VICTION' | 'SETTLUS' | 'GOAT' | 'HYPEREVM' | 'CROSSFI' | 'MEGAETH' | 'MEGAETHTESTNET' | 'BASECAMP' | 'BASECAMPTESTNET' | 'SOMNIA' required
itemIdstring

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

contractstring

Blockchain contract address in Union format ETHEREUM:${token}

collectionstring

Collection id

tokenIdstring
ownerstring required

Blockchain address in Union format ${blockchainGroup}:${token}

valuestring required
source'MINT' | 'PURCHASE' | 'TRANSFER'
createdAtstring date-time required
lastUpdatedAtstring date-time
lazyValuestring required
versioninteger

Example response

{
  "id": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410:0x4765273c477c2dc484da4f1984639e943adccfeb",
  "blockchain": "ETHEREUM",
  "itemId": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410",
  "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430",
  "collection": "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8",
  "owner": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
  "creators": [
    {
      "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
    }
  ],
  "pending": [
    {
      "owner": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
      "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430",
      "royalties": [
        {
          "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
        }
      ]
    }
  ],
  "bestSellOrder": {
    "id": "ETHEREUM:0x19f487016770542dc6137b06499a4f7b42c9580f12d85d6347964b03b7682143",
    "maker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
    "taker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
    "make": {
      "type": {
        "blockchain": "ETHEREUM",
        "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
      }
    },
    "take": {
      "type": {
        "blockchain": "ETHEREUM",
        "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
      }
    },
    "feeTakers": [
      "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
    ],
    "data": {
      "payouts": [
        {
          "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
        }
      ],
      "originFees": [
        {
          "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
        }
      ]
    }
  },
  "originOrders": [
    {
      "bestSellOrder": {
        "id": "ETHEREUM:0x19f487016770542dc6137b06499a4f7b42c9580f12d85d6347964b03b7682143",
        "maker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
        "taker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
        "make": {
          "type": {
            "blockchain": "ETHEREUM",
            "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
          }
        },
        "take": {
          "type": {
            "blockchain": "ETHEREUM",
            "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
          }
        },
        "feeTakers": [
          "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
        ],
        "data": {
          "payouts": [
            {
              "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
            }
          ],
          "originFees": [
            {
              "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
            }
          ]
        }
      },
      "bestBidOrder": {
        "id": "ETHEREUM:0x19f487016770542dc6137b06499a4f7b42c9580f12d85d6347964b03b7682143",
        "maker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
        "taker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
        "make": {
          "type": {
            "blockchain": "ETHEREUM",
            "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
          }
        },
        "take": {
          "type": {
            "blockchain": "ETHEREUM",
            "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
          }
        },
        "feeTakers": [
          "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
        ],
        "data": {
          "payouts": [
            {
              "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
            }
          ],
          "originFees": [
            {
              "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
            }
          ]
        }
      }
    }
  ]
}