`get_collection_stats`

Pack: opensea · Endpoint: https://gateway.pipeworx.io/opensea/mcp

Floor price, volume (24h/7d/30d/all), supply, owners, and best-offer for a collection.

Parameters

Name	Type	Required	Description
`collection_slug`	string	yes	OpenSea collection slug

Example call

Arguments

{
  "collection_slug": "cryptopunks"
}

curl

curl -X POST https://gateway.pipeworx.io/opensea/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_collection_stats","arguments":{"collection_slug":"cryptopunks"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_collection_stats', {
  "collection_slug": "cryptopunks"
});

Response shape

Always returns: slug, floor_price, market_cap, total_volume, total_sales, average_price, num_owners, intervals

Field	Type	Description
`slug`	string	Collection slug
`floor_price`	number \| null	Floor price in ETH or native token
`market_cap`	number \| null	Collection market cap
`total_volume`	number \| null	Total trading volume all-time
`total_sales`	number \| null	Total number of sales all-time
`average_price`	number \| null	Average sale price all-time
`num_owners`	number \| null	Number of unique owners
`intervals`	array	Time-windowed statistics (24h, 7d, 30d)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Collection slug"
    },
    "floor_price": {
      "type": [
        "number",
        "null"
      ],
      "description": "Floor price in ETH or native token"
    },
    "market_cap": {
      "type": [
        "number",
        "null"
      ],
      "description": "Collection market cap"
    },
    "total_volume": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total trading volume all-time"
    },
    "total_sales": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total number of sales all-time"
    },
    "average_price": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average sale price all-time"
    },
    "num_owners": {
      "type": [
        "number",
        "null"
      ],
      "description": "Number of unique owners"
    },
    "intervals": {
      "type": "array",
      "description": "Time-windowed statistics (24h, 7d, 30d)",
      "items": {
        "type": "object",
        "properties": {
          "window": {
            "type": [
              "string",
              "null"
            ],
            "description": "Time interval (24h, 7d, 30d)"
          },
          "volume": {
            "type": [
              "number",
              "null"
            ],
            "description": "Volume in interval"
          },
          "volume_change_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Volume change percentage"
          },
          "sales": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of sales in interval"
          },
          "average_price": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average price in interval"
          }
        }
      }
    }
  },
  "required": [
    "slug",
    "floor_price",
    "market_cap",
    "total_volume",
    "total_sales",
    "average_price",
    "num_owners",
    "intervals"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "opensea": {
      "url": "https://gateway.pipeworx.io/opensea/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_collection_stats