> ## Documentation Index > Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Nft Collection By Address > Get detailed information about an NFT collection using collectionAddress. **3** credits per request
* collectionAddress: Path parameter. NFT collection contract address. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/nft/collection/{collectionAddress} openapi: 3.0.0 info: title: CoinStats Public API description: >- CoinStats Public API — programmatic access to market data, news, NFTs, wallets, exchange connections, and user portfolios. Authenticate every request with the `X-API-KEY` header (or an OAuth Bearer token in the `Authorization` header). Generate keys at https://openapi.coinstats.app. version: '1.0' contact: {} servers: - url: https://openapiv1.coinstats.app security: [] tags: - name: CoinStats description: '' - name: Market Data description: >- The Market Data section of the API provides endpoints to access a wide range of market-related information, including cryptocurrency coins, ticker data, and fiat currency rates. This category offers comprehensive data to help users monitor and analyze the cryptocurrency market, track prices, and gain insights into market trends - name: News description: >- The News section of the API allows you to access news articles and updates related to cryptocurrencies and the blockchain industry. It provides valuable information from various sources to keep you informed about the latest developments - name: NFTs description: >- The NFT section of the API provides endpoints to interact with Non-Fungible Tokens (NFTs), which are unique digital assets stored on a blockchain. These endpoints allow you to retrieve information about NFTs, including collections, assets, trending NFTs, and specific assets associated with wallet addresses. - name: Wallet Data description: >- The Wallet section of the API provides a comprehensive set of endpoints to manage and interact with wallets. It enables users to retrieve wallet balances, monitor syncing status, fetch transaction data, and synchronize wallet information with the blockchain. By integrating these endpoints into your application, you can offer robust wallet functionality to your users. - name: Exchange Connection description: >- The Exchange Connection section of the API provides a comprehensive set of endpoints to manage and interact with exchanges. It enables users to retrieve exchange balances, monitor syncing status, fetch transaction data. By integrating these endpoints into your application, you can offer robust exchange portfolio tracking functionality to your users. - name: User Portfolio description: >- The Portfolio section of the API provides a comprehensive set of endpoints to manage and interact with Share Portfolios. It enables users to retrieve current Portfolio Coins and Transactions. - name: Usage description: The Usage section provides account-level API usage data. - name: Status description: The Status section provides API availability checks. paths: /v1/nft/collection/{collectionAddress}: get: tags: - NFTs summary: >- Get detailed information about an NFT collection using collectionAddress. operationId: get-nft-collection-by-address parameters: - name: collectionAddress required: true in: path description: The address of the NFT collection schema: example: '0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d' type: string responses: '200': description: Get Nft collection content: application/json: schema: $ref: '#/components/schemas/NftCollectionItemResponseDto' '400': description: Bad Request content: application/json: example: statusCode: 400 message: Bad Request requestId: 11111111-2222-3333-4444-555555555555 path: '401': description: Unauthorized content: application/json: example: statusCode: 401 message: Unauthorized requestId: 11111111-2222-3333-4444-555555555555 path: '403': description: Forbidden content: application/json: example: statusCode: 403 message: Forbidden requestId: 11111111-2222-3333-4444-555555555555 path: '404': description: Not Found content: application/json: example: statusCode: 404 message: Not Found requestId: 11111111-2222-3333-4444-555555555555 path: '409': description: Conflict (for some endpoints) content: application/json: example: statusCode: 409 message: Transactions not synced requestId: 11111111-2222-3333-4444-555555555555 path: '429': description: Too Many Requests content: application/json: example: statusCode: 429 message: Rate limit exceeded requestId: 11111111-2222-3333-4444-555555555555 path: '503': description: Service Unavailable content: application/json: example: statusCode: 503 message: Service Unavailable. Please Contact Support security: - X-API-KEY: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d' \ --header 'X-API-KEY: ' - lang: python label: Python source: >- import requests url = "https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d" headers = {"X-API-KEY": ""} response = requests.request("GET", url, headers=headers) print(response.json()) - lang: javascript label: JavaScript source: >- const options = {method: 'GET', headers: {'X-API-KEY': ''}}; fetch('https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d', options) .then((response) => response.json()) .then((response) => console.log(response)) .catch((err) => console.error(err)); - lang: php label: PHP source: |- "https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "X-API-KEY: " ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } - lang: go label: Go source: "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\turl := \"https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d\"\n\n\treq, _ := http.NewRequest(\"GET\", url, nil)\n\n\treq.Header.Add(\"X-API-KEY\", \"\")\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := io.ReadAll(res.Body)\n\n\tfmt.Println(string(body))\n}" - lang: java label: Java source: >- HttpResponse response = Unirest.get("https://openapiv1.coinstats.app/v1/nft/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d") .header("X-API-KEY", "") .asString(); components: schemas: NftCollectionItemResponseDto: type: object properties: address: type: string description: The contract address of the NFT collection example: '0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d' bannerImg: type: string description: URL of the collection banner image example: >- https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/banner/lg.webp blockchain: type: string description: The blockchain network where the NFT collection exists example: ethereum description: type: string description: Detailed description of the NFT collection example: >- The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. img: type: string description: URL of the collection profile image/logo example: >- https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/main/lg.webp name: type: string description: Name of the NFT collection example: Bored Ape Yacht Club relevantUrls: description: >- Array of relevant URLs for the collection (website, social media, etc.) type: array items: $ref: '#/components/schemas/NftItemRelevantUrlType' slug: type: string description: URL-friendly slug identifier for the collection example: bored-ape-yacht-club slugCs: type: string description: CoinStats-specific slug identifier for the collection example: bored_ape_yacht_club source: type: string description: Data source where the collection information originates from example: opensea verified: type: boolean description: Whether the collection is verified by the marketplace or platform example: true rank: type: number description: Ranking position of the collection within its category example: 1 rankAll: type: number description: Overall ranking position across all NFT collections example: 5 averagePrice: type: number description: Average price of NFTs in this collection in main currency example: 14.5 count: type: number description: Total number of NFTs in the collection example: 10000 floorPriceMc: type: number description: Floor price (lowest listed price) in main currency example: 12.8 floorPriceUsd: type: number description: Floor price (lowest listed price) in USD example: 25600 mainCurrencyId: type: string description: >- ID of the main currency used for pricing (usually the blockchain native token) example: ethereum marketcapMc: type: number description: Total market capitalization in main currency example: 128000 marketcapUsd: type: number description: Total market capitalization in USD example: 256000000 oneDayAveragePrice: type: number description: Average price of NFTs sold in the last 24 hours in main currency example: 13.2 oneDaySales: type: number description: Number of NFT sales in the last 24 hours example: 15 ownersCount: type: number description: Total number of unique owners of NFTs in this collection example: 4309 sevenDayAveragePrice: type: number description: Average price of NFTs sold in the last 7 days in main currency example: 12.85 sevenDaySales: type: number description: Number of NFT sales in the last 7 days example: 87 thirtyDayAveragePrice: type: number description: Average price of NFTs sold in the last 30 days in main currency example: 13.45 thirtyDaySales: type: number description: Number of NFT sales in the last 30 days example: 342 thirtyDayVolume: type: number description: Total trading volume in the last 30 days in main currency example: 4598.5 totalSales: type: number description: Total number of sales across the collection lifetime example: 85432 totalSupply: type: number description: Maximum number of NFTs that can exist in this collection example: 10000 totalVolume: type: number description: Total trading volume across the collection lifetime in main currency example: 125000 volumeMc24h: type: number description: Trading volume in the last 24 hours in main currency example: 245.8 volumeMc7d: type: number description: Trading volume in the last 7 days in main currency example: 1685.3 volumeUsd24h: type: number description: Trading volume in the last 24 hours in USD example: 491600 volumeUsd7d: type: number description: Trading volume in the last 7 days in USD example: 3370600 floorPriceChange24h: type: number description: Percentage change in floor price over the last 24 hours example: 5.2 floorPriceChange7d: type: number description: Percentage change in floor price over the last 7 days example: -12.5 marketcapChange24h: type: number description: Percentage change in market capitalization over the last 24 hours example: 8.3 marketcapChange7d: type: number description: Percentage change in market capitalization over the last 7 days example: -7.1 volumeChange24h: type: number description: Percentage change in trading volume over the last 24 hours example: 125.4 volumeChange7d: type: number description: Percentage change in trading volume over the last 7 days example: 45.8 ownersCountChange24h: type: number description: Change in number of unique owners over the last 24 hours example: 12 ownersCountChange7d: type: number description: Change in number of unique owners over the last 7 days example: 87 salesInProfit: type: number description: Number of sales that resulted in profit for the seller example: 78 salesInProfitChange24h: type: number description: Change in profitable sales count over the last 24 hours example: 5 salesInProfitChange7d: type: number description: Change in profitable sales count over the last 7 days example: 23 oneDayChange: type: number description: Percentage change in collection metrics over the last day example: 3.8 transactionsUpdateDate: format: date-time type: string description: Timestamp of the last transaction data update example: '2024-01-15T14:30:25.123Z' sevenDayChange: type: number description: Percentage change in collection metrics over the last 7 days example: 15.2 thirtyDayChange: type: number description: Percentage change in collection metrics over the last 30 days example: -8.5 listedCount: type: number description: Number of NFTs currently listed for sale example: 489 show: type: boolean description: Whether the collection should be displayed in public listings example: true creatorFee: type: number description: Creator royalty fee percentage (in basis points) example: 250 volume: type: number description: Total trading volume for the collection in main currency example: 12845.7 createdDate: format: date-time type: string description: Timestamp when the collection was first created example: '2021-04-30T12:00:00.000Z' required: - address - description - name NftItemRelevantUrlType: type: object properties: name: type: string example: Etherscan url: type: string example: >- https://etherscan.io/address/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d required: - name - url securitySchemes: X-API-KEY: type: apiKey in: header name: X-API-KEY description: >- API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the `X-API-KEY` request header. Never expose your key in client-side code. ````