Get Collections by Exchange

Returns a list of NFT collections on an AMM NFT marketplace.

Endpoint: getNftPoolCollectionsByExchange

Method: POST

Arguments

NameTypeDescription
cursorString

The cursor to use for pagination.

exchangeAddressString!

The NFT AMM marketplace address to filter by.

Required
limitInt

The maximum number of NFT collections to return.

networkIdInt!

The network ID the NFT collection is deployed on.

Required

Response

NameTypeDescription
cursorStringA cursor for use in pagination.
items[NftPoolCollectionResponse]A list of NFT collections.

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

Collections on SudoSwap

Use this query to lookup all NFT collections on SudoSwap (2 results per page)

{
  getNftPoolCollectionsByExchange(
    exchangeAddress: "0xb16c1342E617A5B6E4b631EB114483FDB289c0A4"
    networkId: 1
    limit: 2
  ) {
    items {
      balanceNBT
      collectionAddress
      collectionId
      exchangeAddress
      exchangeId
      floorNBT
      media {
        image
        thumbLg
        thumbSm
      }
      name
      networkId
      nftBalance
      nftVolumeAllTime
      offerNBT
      volumeAllTimeNBT
    }
  }
}
{
  "data": {
    "getNftPoolCollectionsByExchange": {
      "items": [
        {
          "balanceNBT": "17861140629021106801",
          "collectionAddress": "0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258",
          "collectionId": "0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258:1",
          "exchangeAddress": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4",
          "exchangeId": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4:1",
          "floorNBT": "1764312500000000340",
          "media": {
            "image": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/image/0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258:10:1.webp",
            "thumbLg": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbLg/0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258:10:1.webp",
            "thumbSm": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbSm/0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258:10:1.webp"
          },
          "name": "Otherdeed",
          "networkId": 1,
          "nftBalance": 15,
          "nftVolumeAllTime": 183,
          "offerNBT": "1710935643564356220",
          "volumeAllTimeNBT": "313747741627213380174"
        },
        {
          "balanceNBT": "86816868487555076542",
          "collectionAddress": "0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b",
          "collectionId": "0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b:1",
          "exchangeAddress": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4",
          "exchangeId": "0xb16c1342e617a5b6e4b631eb114483fdb289c0a4:1",
          "floorNBT": "321313432835820933",
          "media": {
            "image": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/image/0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b:10:1.webp",
            "thumbLg": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbLg/0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b:10:1.webp",
            "thumbSm": "https://crypto-nft-data-staging.s3.us-west-2.amazonaws.com/thumbSm/0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b:10:1.webp"
          },
          "name": "CloneX",
          "networkId": 1,
          "nftBalance": 5,
          "nftVolumeAllTime": 67,
          "offerNBT": "7761000000000000000",
          "volumeAllTimeNBT": "510723822384770079609"
        }
      ]
    }
  }
}

Explore

πŸ‘‹

Join our Discord

Ask questions, share what you're working on and request new features :two-men-holding-hands::two-women-holding-hands: