Get NFT Collection

Returns an NFT collection with pool stats for a given AMM NFT marketplace.

Endpoint: getNftPoolCollection

Method: POST

Arguments

NameTypeDescription
collectionAddressString!

The contract address of the NFT collection.

Required
exchangeAddressString!

The NFT AMM marketplace address to filter by.

Required
networkIdInt!

The network ID the NFT collection is deployed on.

Required

Response

NameTypeDescription
balanceNBTString!The total liquidity of the collection in the network's base token.
collectionAddressString!The contract address of the NFT collection.
collectionIdString!The ID of the NFT collection (collectionAddress:networkId).
collectionSymbolString!The symbol of the NFT collection.
exchangeAddressString!The contract address of the NFT AMM marketplace.
exchangeIdString!The ID of the exchange (exchangeAddress:networkId).
floorNBTStringThe lowest price at which any of the NFT collection's pools are willing to sell an NFT in the network's base token.
imageStringAn image associated with the NFT collection.
nameStringThe name of the NFT collection.
networkIdInt!The network ID the NFT collection is deployed on.
nftBalanceV2String!The current number of NFTs in all the NFT collection's pools.
nftVolumeAllTimeV2StringThe total number of NFTs bought and sold over the collection's lifetime.
offerNBTStringThe highest price at which any of the NFT collection's pools are willing to buy an NFT in the network's base token.
poolFeesNBTAllStringThe sum of pool fees generated by the collection in the network's base token over the collection's lifetime.
poolFeesUSDAllStringThe sum of pool fees generated by the collection in USD over the collection's lifetime.
protocolFeesNBTAllStringThe sum of protocol fees generated by the collection in the network's base token over the collection's lifetime.
protocolFeesUSDAllStringThe sum of protocol fees generated by the collection in USD over the collection's lifetime.
royaltiesNBTAllEstimateStringAs estimated sum in the network's base token of the collection's royalties paid to creators by pool swaps over the collection's lifetime.
royaltiesUSDAllEstimateStringAn estimated sum in USD of the collection's royalties paid to creators by pool swaps over the collection's lifetime.
volumeAllTimeNBTStringThe total volume of the collection in the network's base token over the collection's lifetime.
volumeAllTimeUSDStringThe total volume of the collection in USD over the collection's lifetime.

Example

Find Azuki Collection

Use this query to get SudoSwap's Azuki stats and media.

{
  getNftPoolCollection(
    collectionAddress: "0xed5af388653567af2f388e6224dc7c4b3241c544"
    exchangeAddress: "0xb16c1342E617A5B6E4b631EB114483FDB289c0A4"
    networkId: 1
  ) {
    balanceNBT
    collectionAddress
    collectionId
    exchangeAddress
    exchangeId
    floorNBT
    media {
      image
      thumbLg
      thumbSm
    }
    name
    networkId
    nftBalance
    nftVolumeAllTime
    offerNBT
    volumeAllTimeNBT
  }
}
{
  "data": {
    "getNftPoolCollection": {
      "balanceNBT": "99049545153563425190",
      "collectionAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "collectionId": "0xed5af388653567af2f388e6224dc7c4b3241c544:1",
      "exchangeAddress": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4",
      "exchangeId": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4:1",
      "floorNBT": "9165000000000000000",
      "media": {
        "image": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/image/0xed5af388653567af2f388e6224dc7c4b3241c544:1000:1.webp",
        "thumbLg": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbLg/0xed5af388653567af2f388e6224dc7c4b3241c544:1000:1.webp",
        "thumbSm": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbSm/0xed5af388653567af2f388e6224dc7c4b3241c544:1000:1.webp"
      },
      "name": "Azuki",
      "networkId": 1,
      "nftBalance": 18,
      "nftVolumeAllTime": 29,
      "offerNBT": "9165000000000000000",
      "volumeAllTimeNBT": "263665331514991482719"
    }
  }
}

Explore

πŸ‘‹

Join our Discord

Ask questions, share what you're working on and request new features πŸ‘¬πŸ‘­