Skip to main content

Fetch a collection

Information, items, attributes and statistics

Information and statistics​

You would have to use the collection query with the contract hex address parameter.

Graphql Example​

Request​

query Collection {
  collection(address: "0x3caf681231bd99df1d2247f41f8e5f02e750fc5e") {
    collection {
      name
      address
      avatar
      owner_address
      certified
      kind
      creator_address
      symbol
      description
      banner
      thumbnails
      twitter
      facebook
      telegram
      discord
      instagram
      youtube
      website
      creator_name
    }
    stats {
      total_minted
      total_owners
      in_sale
      sold
      volume
      weekly_volume
      floor_price
      highest_price
      average_price
      average_royalties_percent
    }
  }
}
With CURL​
curl -H 'content-type: application/json' \
  -d '{"query":"query Collection { collection(address: \"0x3caf681231bd99df1d2247f41f8e5f02e750fc5e\") { collection {\n     name\n      address\n      avatar\n      owner_address\n      certified\n      kind\n      creator_address\n      symbol\n      description\n      banner\n      thumbnails\n      twitter\n      facebook\n      telegram\n      discord\n      instagram\n      youtube\n      website\n      creator_name\n    }\n    stats {\n      total_minted\n      total_owners\n      in_sale\n      sold\n      volume\n      weekly_volume\n      floor_price\n      highest_price\n      average_price\n      average_royalties_percent\n    }\n  }\n}","variables":null,"operationName":"Collection"}' \
  https://public-api.dev.kalao.io/query
Response​
{
  "data": {
    "collection": {
      "collection": {
        "name": "Ryu NFTs test",
        "address": "0x3caf681231bd99df1d2247f41f8e5f02e750fc5e",
        "avatar": "https://storage.kalao.io/collections/avatars/go-ryu-a.jpg",
        "owner_address": "",
        "certified": true,
        "kind": "erc721",
        "creator_address": "0x20dbf6ad54bdae76e42aee8960b7e2e56a053eff",
        "symbol": "RYUTEST",
        "description": "Gen1 dragons include 3234 base and 99 legendary which can breed and be staked for daily $ryu",
        "banner": "https://storage.kalao.io/collections/covers/go-ryu-c.jpg",
        "thumbnails": [
          "https://storage.googleapis.com/beta-kalao/nfts/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e_32/thumbnail",
          "https://storage.googleapis.com/beta-kalao/nfts/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e_16/thumbnail",
          "https://storage.googleapis.com/beta-kalao/nfts/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e/36/thumbnail",
          "https://storage.googleapis.com/beta-kalao/nfts/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e/37/thumbnail",
          "https://storage.googleapis.com/beta-kalao/nfts/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e/0x3caf681231bd99df1d2247f41f8e5f02e750fc5e_33/thumbnail"
        ],
        "twitter": "https://twitter.com/ryunft?s=21",
        "facebook": "",
        "telegram": "",
        "discord": "https://discord.gg/ryu",
        "instagram": "",
        "youtube": "",
        "website": "https://ryunft.com",
        "creator_name": "anonymous"
      },
      "stats": {
        "total_minted": "38",
        "total_owners": 17,
        "in_sale": 1,
        "sold": 39,
        "volume": 39.92900085449219,
        "weekly_volume": 0,
        "floor_price": 1,
        "highest_price": 4,
        "average_price": 0,
        "average_royalties_percent": 3
      }
    }
  }
}