OpenSea Collections

{  "type": "object",  "additionalProperties": false,  "properties": {    "sortBy": {      "type": "string",      "enum": [        "VOLUME",        "ONE_MINUTE_VOLUME",        "FIVE_MINUTE_VOLUME",        "FIFTEEN_MINUTE_VOLUME",        "ONE_HOUR_VOLUME",        "ONE_DAY_VOLUME",        "SEVEN_DAYS_VOLUME",        "THIRTY_DAYS_VOLUME"      ],      "title": "Rank by",      "description": "Which volume window ranks the table. Only the volume family is offered — OpenSea accepts FLOOR_PRICE and SALES and then drops the connection.",      "default": "VOLUME"    },    "sortDirection": {      "type": "string",      "enum": [        "DESC",        "ASC"      ],      "title": "Direction",      "default": "DESC"    },    "chains": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Chains",      "description": "Chain slugs — ethereum, solana, base, polygon, hyperevm. Empty collects every chain. An unknown slug fails the whole page, so check spelling.",      "default": [],      "examples": [        "ethereum"      ]    },    "category": {      "type": "string",      "maxLength": 2000,      "title": "Category",      "description": "OpenSea's own taxonomy, upper-cased: PFPS, ART, GAMING, … An unrecognised value fails the page rather than being ignored.",      "examples": [        "PFPS"      ]    },    "ownerAddress": {      "type": "string",      "maxLength": 2000,      "title": "Owned by wallet",      "description": "Collect only the collections this wallet owns. OpenSea's own filter, so it is exact rather than a search — a wallet nobody matches returns an empty first page, which is warned about.",      "examples": [        "0x…"      ]    },    "maxCollections": {      "type": "number",      "minimum": 1,      "maximum": 50000,      "title": "Max collections per run",      "description": "Ceiling on rows collected. Paging was walked past 25,000 collections without a duplicate or a refusal, so this bounds the run rather than the endpoint. Rows upsert, so it bounds one run rather than the dataset, and a ceiling that truncates the listing is reported as a warning.",      "default": 1000    },    "enrichHolders": {      "type": "boolean",      "title": "Sample holders",      "description": "Walk each collection’s tokens and record the wallets behind them, with their OpenSea portfolio value and X handle. Costs one request per 100 tokens.",      "default": false    },    "holderCollections": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Sample only these slugs",      "description": "Restrict holder sampling to named collections. Empty samples the highest-ranked ones this run collected.",      "default": [],      "examples": [        "cryptopunks"      ]    },    "maxHolderCollections": {      "type": "number",      "minimum": 1,      "maximum": 500,      "title": "Max collections sampled",      "default": 10    },    "holderItemsPerCollection": {      "type": "number",      "minimum": 1,      "maximum": 20000,      "title": "Tokens walked per collection",      "description": "A sample, not a census: 6,000 tokens of BAYC yielded 3,661 distinct wallets. One request per 100 tokens, and paging held for every one of those 60 pages.",      "default": 500    },    "topHoldersKept": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Top holders stored per collection",      "description": "Richest first. The counts and the median are computed over the whole sample regardless of this.",      "default": 50    },    "holderValueSource": {      "type": "string",      "enum": [        "opensea",        "nftscan"      ],      "title": "Portfolio valuation from",      "description": "opensea is free and arrives inline. nftscan needs NFTSCAN_API_KEY and costs one request per wallet; without a key the run fails rather than silently downgrading.",      "default": "opensea"    },    "nftscanApiKey": {      "type": "string",      "maxLength": 2000,      "title": "NFTScan API key",      "description": "Overrides the NFTSCAN_API_KEY environment variable. Only read when the valuation source is nftscan."    },    "collectionsPerPage": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "Collections per request",      "description": "OpenSea rejects anything above 100.",      "default": 100    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "description": "The endpoint reports a 400-request budget in its own response extensions; 500 ms keeps a long run comfortably inside it. 252 consecutive pages at 400 ms drew no refusal on 2026-09-03.",      "default": 500    }  }}