icy.tools API

Cryptocurrency / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

icy.tools (now powered by QuickNode) is a GraphQL-based NFT API that provides data on NFT collections, wallet holdings, and historical transaction activity across major blockchains. It enables developers to query NFT metadata, floor prices, and ownership history with flexible GraphQL queries rather than fixed REST routes. Typical use cases include NFT portfolio dashboards, rarity checkers, and marketplace analytics tools.

💡

Beginner Tip

Unlike typical REST APIs, icy.tools uses GraphQL — you send POST requests with a JSON body containing a "query" string, which gives you precise control over exactly which NFT data fields you receive.

Available Data

coin price in USD/EUR
market capitalization
24h price change
trading volume
circulating supply
Use case: Integrate graphql based nft api data into web and mobile applications

Example Response

JSON Response
{
  "id": "bitcoin",
  "symbol": "btc",
  "current_price": 65432.1,
  "market_cap": 1280000000000,
  "price_change_24h": 1250.5,
  "price_change_percentage_24h": 1.95,
  "total_volume": 28500000000
}

Field Reference

data.contract.name The human-readable name of the NFT collection contract.
data.contract.symbol Short ticker symbol for the NFT collection.
data.contract.stats.floor Current floor price of the collection in ETH.
errors List of GraphQL errors if the query failed; null when successful.

Implementation Example

const url = "https://developers.icy.tools/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

UNAUTHENTICATED error in GraphQL response The API key is missing from the request headers.
Add the x-api-key header to every request: curl -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" icy.tools/graphql
GraphQL syntax error Malformed GraphQL query string, such as missing braces or incorrect field names.
Use the GraphQL Playground at the API endpoint URL to test queries interactively before embedding them in code.
Field does not exist error Requesting a field name that differs from the schema — NFT API schemas use camelCase field names.
Run an introspection query or check the QuickNode/icy.tools schema docs to confirm exact field names.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Cryptocurrency
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →