Web3 developers, meet GraphQL

Fetch powerful market insights, historical trading data, cached NFT images, and more with our simple GraphQL API.

# Find current trending collections
query TrendingCollections {
  trendingCollections(orderBy: SALES, orderDirection: DESC, timePeriod: ONE_HOUR ) {
    edges {
      node {
        address
        ... on ERC721Contract {
          name
          stats {
            totalSales
            average
            ceiling
            floor
            volume
          }
          symbol
        }
      }
    }
  }
}

# Query that looks up the images for BAYC#1
query TokenImages {
  token(
    contractAddress: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    tokenId: "1,
  ) {
    ... on ERC721Token {
      images {
        url
        width
        height
        mimeType
      }
    }
  }
}

# Query that looks up the owner of BAYC#1
query TokenOwner {
  token(
    contractAddress: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    tokenId: "1"
  ) {
    ... on ERC721Token {
      owner {
        address
        ensName
      }
    }
  }
}

# Query that looks up mevcollector.eth's NFTs
query WalletTokens {
    wallet(ensName: "mevcollector.eth") {
      tokens {
        edges {
          node {
            tokenId
            contract {
              ... on ERC721Contract {
                symbol
                name
              }
            }
          }
        }
      }
    }
  }

Response

{
  "data": {
    "trendingCollections": {
      "edges": [
        {
          "node": {
            "address": "0x8052a3765df60dff44eb911982c8ef1ca107ba1a",
            "name": "PhasesNFT Official",
            "stats": {
              "totalSales": 657,
              "average": 0.0466043698630137,
              "ceiling": 0.051,
              "floor": 0.047,
              "volume": 30.619071
            },
            "symbol": "PHASE"
          }
        },
        {
          "node": {
            "address": "0x6a48a272210eaa205c279e1c862f87875c623ae2",
            "name": "KATATONIK",
            "stats": {
              "totalSales": 222,
              "average": 0.16798093693693694,
              "ceiling": 0.17,
              "floor": 0.165,
              "volume": 37.291768
            },
            "symbol": "KATS"
          }
        },
        {
          "node": {
            "address": "0x39ee2c7b3cb80254225884ca001f57118c8f21b6",
            "name": "The Potatoz",
            "stats": {
              "totalSales": 181,
              "average": 0.598166906077348,
              "ceiling": 0.62,
              "floor": 0.6189,
              "volume": 108.26821
            },
            "symbol": "Potatoz"
          }
        },
        {
          "node": {
            "address": "0x684e4ed51d350b4d76a3a07864df572d24e6dc4c",
            "name": "Isekai Meta",
            "stats": {
              "totalSales": 156,
              "average": 0.18767102564102564,
              "ceiling": 0.185,
              "floor": 0.179,
              "volume": 29.27668
            },
            "symbol": "ISEKAI"
          }
        },
        {
          "node": {
            "address": "0x64ce124acb65046c8ec62a98dfff4ad8c7626b6b",
            "name": "potatoztown",
            "stats": {
              "totalSales": 136,
              "average": 0.0055423382352941175,
              "ceiling": 0.0039,
              "floor": 0.0027,
              "volume": 0.753758
            },
            "symbol": "POTATOZ"
          }
        },
        {
          "node": {
            "address": "0xd2669aefca82e23d1b0a94459deafd656f6b719a",
            "name": "Etherjump Plots",
            "stats": {
              "totalSales": 123,
              "average": 0.1968999105691057,
              "ceiling": 0.299,
              "floor": 0.179,
              "volume": 24.218689
            },
            "symbol": "EJPLOTS"
          }
        },
        {
          "node": {
            "address": "0x6866ab4d2bfc8254430d32f152f07da9382035c2",
            "name": "REALFKNCLOWNZ",
            "stats": {
              "totalSales": 71,
              "average": 0.0062481690140845075,
              "ceiling": 0.006,
              "floor": 0.0041,
              "volume": 0.44362
            },
            "symbol": "FKN"
          }
        },
        {
          "node": {
            "address": "0xedd7e4eee7c0ffb2e3d328a3801d611377b0b7bf",
            "name": "Moonbaycs Official",
            "stats": {
              "totalSales": 58,
              "average": 0.00751,
              "ceiling": 0.009,
              "floor": 0.0055,
              "volume": 0.43558
            },
            "symbol": "MAPE"
          }
        },
        {
          "node": {
            "address": "0x8f2cef1cbff23d7d657ddbae39650bb860e87132",
            "name": "ANIM.JP Official",
            "stats": {
              "totalSales": 49,
              "average": 0.050077551020408166,
              "ceiling": 0.16,
              "floor": 0.038,
              "volume": 2.4538
            },
            "symbol": "AJP"
          }
        },
        {
          "node": {
            "address": "0x2d0d57d004f82e9f4471caa8b9f8b1965a814154",
            "name": "Pepe Ape Yacht Club",
            "stats": {
              "totalSales": 38,
              "average": 0.011276447368421053,
              "ceiling": 0.011,
              "floor": 0.0063,
              "volume": 0.428505
            },
            "symbol": "PAYC"
          }
        },
        {
          "node": {
            "address": "0xdb042927c36791bd500698c7d1bd81b6864229b5",
            "name": "Elfiverse NFT Collection",
            "stats": {
              "totalSales": 37,
              "average": 0.09305405405405405,
              "ceiling": 0.099,
              "floor": 0.095,
              "volume": 3.443
            },
            "symbol": "ELF"
          }
        },
        {
          "node": {
            "address": "0x94af96ae8ecc593d986edc66d595b7f8aa5cadb2",
            "name": "Monsters Inside NFT Official",
            "stats": {
              "totalSales": 29,
              "average": 0.0019109655172413792,
              "ceiling": 0.0021,
              "floor": 0.0013,
              "volume": 0.055418
            },
            "symbol": "MI"
          }
        },
        {
          "node": {
            "address": "0x4ef3d9eab34783995bc394d569845585ac805ef8",
            "name": "The Americans NFT",
            "stats": {
              "totalSales": 26,
              "average": 0.08472188461538462,
              "ceiling": 0.15,
              "floor": 0.059,
              "volume": 2.202769
            },
            "symbol": "TAs"
          }
        },
        {
          "node": {
            "address": "0xe727e3994fda69f1b7d239887539e84d795de66e",
            "name": "MarionLab Official",
            "stats": {
              "totalSales": 25,
              "average": 0.0065696,
              "ceiling": 0.00675,
              "floor": 0.005,
              "volume": 0.16424
            },
            "symbol": "MARION"
          }
        },
        {
          "node": {
            "address": "0x52c5dd8a4ffb5a24121d76c222014697b5e6cc6e",
            "name": "Maximalists",
            "stats": {
              "totalSales": 24,
              "average": 0.0104625,
              "ceiling": 0.025,
              "floor": 0.0055,
              "volume": 0.2511
            },
            "symbol": "MAXI"
          }
        },
        {
          "node": {
            "address": "0x7b41874efe38ea0e4866307b7208d9c856745d31",
            "name": "WeAre by John Johnny",
            "stats": {
              "totalSales": 24,
              "average": 0.009749125,
              "ceiling": 0.01,
              "floor": 0.0099,
              "volume": 0.233979
            },
            "symbol": "WeAre"
          }
        },
        {
          "node": {
            "address": "0x6b3c2dd23251d95c34c4f5a3b20140e2881cc36d",
            "name": "Realms of Ethernity Mounts",
            "stats": {
              "totalSales": 22,
              "average": 0.015478136363636364,
              "ceiling": 0.015,
              "floor": 0.01313,
              "volume": 0.340519
            },
            "symbol": "MOUNT"
          }
        },
        {
          "node": {
            "address": "0x8770792963e0486368ff6e5713ed1f357335cbf8",
            "name": "Bored Oddities",
            "stats": {
              "totalSales": 21,
              "average": 0.0019405238095238095,
              "ceiling": 0.00298,
              "floor": 0.0014,
              "volume": 0.040751
            },
            "symbol": "BRDODD"
          }
        },
        {
          "node": {
            "address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
            "name": "ENS: Ethereum Name Service",
            "stats": {
              "totalSales": 19,
              "average": 0.3061315789473684,
              "ceiling": 0.59,
              "floor": 0.0029,
              "volume": 5.8165
            },
            "symbol": null
          }
        },
        {
          "node": {
            "address": "0xc5351f93b67895f6dd0df0e0c2be0fc6fec89c4c",
            "name": "The Inhabitants of Lyke Island",
            "stats": {
              "totalSales": 18,
              "average": 0.1826888888888889,
              "ceiling": 0.45,
              "floor": 0.028,
              "volume": 3.2884
            },
            "symbol": "LYKEIN"
          }
        },
        {
          "node": {
            "address": "0x223e16c52436cab2ca9fe37087c79986a288fffa",
            "name": "Nickelodeon: Rugrats & Hey Arnold! (ETH)",
            "stats": {
              "totalSales": 16,
              "average": 0.226075,
              "ceiling": 0.333,
              "floor": 0.13,
              "volume": 3.6172
            },
            "symbol": "NICK"
          }
        },
        {
          "node": {
            "address": "0x3d6d52dd2150ef2315a2f13ec229c41910c52a7b",
            "name": "il Pensiero by Rosalia Linari",
            "stats": {
              "totalSales": 16,
              "average": 2.346625,
              "ceiling": 13.03,
              "floor": 0.2,
              "volume": 37.546
            },
            "symbol": "PSO"
          }
        },
        {
          "node": {
            "address": "0x5f1cbe84d44e292fe3eae51b87f34bbdc8f04fc8",
            "name": "BBYC Bored Bits Yacht Club",
            "stats": {
              "totalSales": 16,
              "average": 0.02163125,
              "ceiling": 0.0248,
              "floor": 0.015,
              "volume": 0.3461
            },
            "symbol": "BBYC"
          }
        },
        {
          "node": {
            "address": "0x249b90956ea0f80c2cb902dccde246b66a21d401",
            "name": "Eyeverse.world",
            "stats": {
              "totalSales": 15,
              "average": 0.04154513333333333,
              "ceiling": 0.044444,
              "floor": 0.04,
              "volume": 0.623177
            },
            "symbol": "Eyeverse"
          }
        },
        {
          "node": {
            "address": "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270",
            "name": "Art Blocks",
            "stats": {
              "totalSales": 15,
              "average": 2.286,
              "ceiling": 0.555,
              "floor": 0.042,
              "volume": 34.29
            },
            "symbol": "BLOCKS"
          }
        }
      ]
    }
  }
}

Launch your next project 10x faster

Access blockchain data

The Icy API makes it a breeze to query on-chain data. Fetch collections, tokens, traits, wallets, and more through simple calls.

Pricing and valuation

We currently offer NFT sale insights that give accurate floor, average, and volume data for you to use in your application.

Realiability and uptime

Our data is dependent upon by traders who need to make to-the-minute decisions. We treat system reliability with importance.

MULTI STACK

Get started using your favorite language

The possibilities are endless with the Icy api. Focus on what matters and launch faster.

import {
  ApolloClient,
  InMemoryCache,
  ApolloProvider,
} from "@apollo/client";


const client = new ApolloClient({
  uri: 'https://graphql.icy.tools/graphql',
  cache: new InMemoryCache()
});

render(
  <ApolloProvider client={client}>
    <App />
  </ApolloProvider>,
  document.getElementById('root'),
);

Start using real time token data

Bootstrap your project in minutes, not hours

Doodle #9243

Doodles

Ξ 418.1

15%

import {
  useQuery,
  gql
} from "@apollo/client";

const GET_TOKEN_IMAGES = gql`
  query TokenImages($contractAddress: String!, $tokenId: String!) {
    token(
      contractAddress: $contractAddress,
      tokenId: $tokenId,
    ) {
      ... on ERC721Token {
        images {
          url
          width
          height
          mimeType
        }
      }
    }
  }
`;

function TokenImage() {
  const { loading, error, data } = useQuery(GET_TOKEN_IMAGES, {
    variables: {
      contractAddress: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e',
      tokenId: 9243
    },
  });

  if (loading) return null;
  if (error) return `Error! ${error}`;

  return (
    <img src={data.token.images[0].url} />
  );
}

Works with all markets

Easily invite your team

INVITE

Pricing

Discover

Get up and running quickly—build in our sandbox and start getting realtime NFT data.

Free

Up to 1m req/mo
50 req/min, burst up to 5 req/sec
Access to 7 day historical data
Fully indexed ERC721 data
Powerful GraphQL API