{ "openapi": "3.0.3", "info": { "title": "NFT Price Floor API", "version": "1.0.0", "description": "Comprehensive API for NFT collection data, floor prices, historical data, and market analytics.", "contact": { "name": "NFT Price Floor API Support", "url": "https://nftpricefloor.com", "email": "support@nftpricefloor.com" }, "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" } }, "servers": [ { "url": "https://nftpf-api-v0.p.rapidapi.com/", "description": "Production server" } ], "security": [ { "RapidAPIKey": [] } ], "components": { "securitySchemes": { "RapidAPIKey": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Key" } } }, "paths": { "/projects-v2": { "get": { "summary": "Get all NFT collections", "description": "Retrieve a list of all NFT collections with their current stats and floor price information.", "tags": ["Collections"], "responses": { "200": { "description": "A list of NFT collections", "content": { "application/json": { "schema": { "type": "object", "properties": { "projects": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "ranking": { "type": "integer" }, "imageBlur": { "type": "string", "description": "Base64-encoded image string" }, "stats": { "type": "object", "properties": { "totalSupply": { "type": "integer" }, "listedCount": { "type": "integer" }, "ownersCount": { "type": "integer" }, "floorInfo": { "type": "object", "properties": { "currentFloorEth": { "type": "number" }, "currentFloorUsd": { "type": "number" }, "tokenInfo": { "type": "object", "properties": { "contract": { "type": "string" }, "tokenId": { "type": "string" }, "blockchain": { "type": "string" }, "source": { "type": "string" } } } } }, "floorCapEth": { "type": "number" }, "floorCapUsd": { "type": "number" }, "floorTemporalityEth": { "type": "number" }, "floorTemporalityUsd": { "type": "number" }, "salesTemporalityEth": { "type": "number" }, "salesTemporalityUsd": { "type": "number" }, "count": { "type": "integer" } } }, "creator": { "type": "string" }, "parentCollection": { "type": "string", "nullable": true }, "subCollection": { "type": "boolean" }, "types": { "type": "array", "items": { "type": "string" } }, "blockchain": { "type": "string" }, "bestPriceUrl": { "type": "string", "format": "uri" }, "updatedAt": { "type": "string", "format": "date-time" }, "reservoirCollectionId": { "type": "string" } } } } } }, "example": { "projects": [ { "name": "Bored Ape Yacht Club", "slug": "boredapeyachtclub", "ranking": 1, "imageBlur": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...", "stats": { "totalSupply": 10000, "listedCount": 582, "ownersCount": 6397, "floorInfo": { "currentFloorEth": 29.5, "currentFloorUsd": 47200.15, "tokenInfo": { "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", "tokenId": "1234", "blockchain": "ethereum", "source": "opensea" } }, "floorCapEth": 295000, "floorCapUsd": 472001500, "floorTemporalityEth": 2.5, "floorTemporalityUsd": 4000.12, "salesTemporalityEth": 234.5, "salesTemporalityUsd": 375200.75, "count": 45 }, "creator": "Yuga Labs", "parentCollection": null, "subCollection": false, "types": ["pfp", "art"], "blockchain": "ethereum", "bestPriceUrl": "https://opensea.io/collection/boredapeyachtclub", "updatedAt": "2024-01-15T10:30:00Z", "reservoirCollectionId": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d" } ] } } } } } } }, "/projects/{slug}": { "get": { "summary": "Get details of a specific NFT collection", "description": "Retrieve detailed information about a specific NFT collection by its slug identifier.", "tags": ["Collections"], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "example": "azuki", "description": "The unique slug identifier for the NFT collection" } ], "responses": { "200": { "description": "NFT collection details", "content": { "application/json": { "schema": { "type": "object", "properties": { "stats": { "type": "object", "properties": { "projectId": { "type": "string" }, "slug": { "type": "string" }, "totalSupply": { "type": "integer" }, "listedCount": { "type": "integer" }, "totalOwners": { "type": "integer" }, "floorInfo": { "type": "object", "properties": { "currentFloorEth": { "type": "number" }, "currentFloorUsd": { "type": "number" }, "tokenInfo": { "type": "object", "properties": { "contract": { "type": "string" }, "tokenId": { "type": "string" }, "blockchain": { "type": "string" }, "source": { "type": "string" } } } } }, "floorCapEth": { "type": "number" }, "floorCapUsd": { "type": "number" }, "floorTemporalityEth": { "type": "number" }, "floorTemporalityUsd": { "type": "number" }, "salesTemporalityEth": { "type": "number" }, "salesTemporalityUsd": { "type": "number" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "details": { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "ranking": { "type": "integer" }, "imageBlur": { "type": "string", "description": "Base64-encoded image string" }, "releaseDate": { "type": "string", "format": "date" }, "creator": { "type": "string" }, "parentCollection": { "type": "string", "nullable": true }, "subCollection": { "type": "boolean" }, "types": { "type": "array", "items": { "type": "string" } }, "blockchain": { "type": "string" }, "totalSupply": { "type": "integer" }, "socialMedia": { "type": "object", "properties": { "twitter": { "type": "string", "format": "uri" }, "discord": { "type": "string", "format": "uri" }, "website": { "type": "string", "format": "uri" } } }, "contract": { "type": "string" }, "textEn": { "type": "string" }, "textEs": { "type": "string" }, "floorPriceEth": { "type": "number" }, "floorPriceUsd": { "type": "number" }, "floorInfo": { "type": "object", "properties": { "currentFloorEth": { "type": "number" }, "currentFloorUsd": { "type": "number" } } }, "marketplaces": { "type": "array", "items": { "type": "string" } }, "bestPriceUrl": { "type": "string", "format": "uri" }, "creatorsFee": { "type": "number" }, "creatorsFeePayoutAddress": { "type": "string" }, "mintPriceEth": { "type": "number" }, "mintPriceUsd": { "type": "number" }, "reservoirCollectionId": { "type": "string" } } } } } } } } } } }, "/projects/{slug}/history": { "get": { "summary": "Get historical floor price data for an NFT collection", "description": "Retrieve historical floor price data for a specific NFT collection over different time intervals.", "tags": ["Historical Data"], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The unique slug identifier for the NFT collection" }, { "name": "interval", "in": "query", "schema": { "type": "string", "enum": ["1d", "7d", "30d", "90d", "180d", "365d", "all"] }, "description": "Time interval for historical data" } ], "responses": { "200": { "description": "Historical floor price data", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "floorPrice": { "type": "number" }, "floorPriceUSD": { "type": "number" } } } } } } } } } }, "/projects/{slug}/history/pricefloor/1d": { "get": { "summary": "Get 1-day floor price history for a collection with custom date ranges", "description": "Retrieve detailed 1-day granular floor price history for a collection within specified date ranges.", "tags": ["Historical Data"], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "example": "azuki", "description": "The unique slug identifier for the NFT collection" }, { "name": "start", "in": "query", "required": false, "schema": { "type": "integer" }, "example": 1754006399, "description": "Start timestamp (Unix timestamp)" }, { "name": "end", "in": "query", "required": false, "schema": { "type": "integer" }, "example": 1756206006, "description": "End timestamp (Unix timestamp)" } ], "responses": { "200": { "description": "Floor price history within a date range (arrays are index-aligned: each index corresponds to the same date)", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "granularity": { "type": "string", "example": "1d" }, "timestamps": { "type": "array", "items": { "type": "integer", "description": "Unix timestamp" } }, "floorEth": { "type": "array", "items": { "type": "number" } }, "floorUsd": { "type": "array", "items": { "type": "number" } }, "volumeEth": { "type": "array", "items": { "type": "number" } }, "volumeUsd": { "type": "array", "items": { "type": "number" } }, "salesCount": { "type": "array", "items": { "type": "integer" } } } }, "example": { "slug": "azuki", "granularity": "1d", "timestamps": [1640995200, 1641081600, 1641168000], "floorEth": [15.2, 14.8, 15.5], "floorUsd": [24320, 23680, 24800], "volumeEth": [1250.5, 980.2, 1456.8], "volumeUsd": [2000800, 1568320, 2330880], "salesCount": [45, 32, 67] } } } } } } }, "/brands/stats": { "get": { "summary": "Get statistics for NFT brands", "description": "Retrieve comprehensive statistics and analytics for NFT brands and creators.", "tags": ["Brands & Creators"], "responses": { "200": { "description": "Statistics for brands", "content": { "application/json": { "schema": { "type": "object", "properties": { "brands": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "ranking": { "type": "integer" }, "totalProjects": { "type": "integer" }, "floorCapEth": { "type": "number" }, "floorCapUsd": { "type": "number" }, "totalFloorCollectionsUp": { "type": "integer" }, "totalFloorCollectionsDown": { "type": "integer" }, "totalFloorCollectionsNoChange": { "type": "integer" }, "floorCapTemporalityEth": { "type": "number" }, "floorCapTemporalityUsd": { "type": "number" }, "marketDominance": { "type": "number" }, "aggregatedSales": { "type": "integer" }, "aggregatedVolumeEth": { "type": "number" }, "aggregatedVolumeUsd": { "type": "number" }, "socialMedia": { "type": "object", "properties": { "twitter": { "type": "string", "format": "uri" }, "website": { "type": "string", "format": "uri" } } } } } } } }, "example": { "brands": [ { "name": "Yuga Labs", "type": "creator", "ranking": 1, "totalProjects": 5, "floorCapEth": 450000, "floorCapUsd": 720000000, "totalFloorCollectionsUp": 3, "totalFloorCollectionsDown": 1, "totalFloorCollectionsNoChange": 1, "floorCapTemporalityEth": 12500.5, "floorCapTemporalityUsd": 20000800, "marketDominance": 15.2, "aggregatedSales": 1250, "aggregatedVolumeEth": 25680.7, "aggregatedVolumeUsd": 41089120, "socialMedia": { "twitter": "https://twitter.com/yugalabs", "website": "https://yugalabs.io" } } ] } } } } } } }, "/creators/stats": { "get": { "summary": "Get statistics for NFT creators", "description": "Retrieve comprehensive statistics and performance metrics for individual NFT creators.", "tags": ["Brands & Creators"], "responses": { "200": { "description": "Statistics for creators", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "ranking": { "type": "integer" }, "totalProjects": { "type": "integer" }, "floorCapNative": { "type": "number" }, "floorCapUsd": { "type": "number" }, "totalFloorCollectionsUp": { "type": "integer" }, "totalFloorCollectionsDown": { "type": "integer" }, "totalFloorCollectionsNoChange": { "type": "integer" }, "floorCapTemporalityNative": { "type": "object", "properties": { "val24h": { "type": "number" }, "diff24h": { "type": "number" }, "val7d": { "type": "number" }, "diff7d": { "type": "number" }, "val14d": { "type": "number" }, "diff14d": { "type": "number" }, "val30d": { "type": "number" }, "diff30d": { "type": "number" }, "val90d": { "type": "number" }, "diff90d": { "type": "number" } } }, "floorCapTemporalityUsd": { "type": "object", "properties": { "val24h": { "type": "number" }, "diff24h": { "type": "number" }, "val7d": { "type": "number" }, "diff7d": { "type": "number" }, "val14d": { "type": "number" }, "diff14d": { "type": "number" }, "val30d": { "type": "number" }, "diff30d": { "type": "number" }, "val90d": { "type": "number" }, "diff90d": { "type": "number" } } } } } } } } } } } } }, "tags": [ { "name": "Collections", "description": "Operations related to NFT collections and their details" }, { "name": "Historical Data", "description": "Historical price and market data for NFT collections" }, { "name": "Brands & Creators", "description": "Statistics and analytics for NFT brands and creators" } ] }