nft-collection-liquidity-research

Compare observed OpenSea collection depth, bids/asks, activity, holders, and traits through Crawlora. Use for a source-attributed liquidity snapshot with chain/contract/item identity, cumulative quantities, currencies, eligibility, observation time, and incomplete coverage preserved.

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Describe observed marketplace depth and activity for a supplied or discovered collection set. Establish chain, contract/collection identity, item/trait scope, quote currency, time window, and what depth/activity comparison is needed.

Resolve collection identity and distinct surfaces

• Discover chains/categories and collection slugs, then verify actual contract, chain, creator, and canonical URL when supplied. Similar display names and collection slugs do not prove authenticity or that two contracts represent the same assets. Item identity needs chain + contract + token ID, not token ID alone.
• Keep active listings, offers, collection/trait offers, sales, transfers, mints, and holder balances separate. event_types=SALE selects a sales feed; transfer or mint events are not purchases. A top-sales shelf is fixed-size and price-ranked, not a chronological complete sales history. Copy opaque returned page cursors.
• Collection depth exposes price levels with cumulative quantities. Preserve ladder order and distinguish cumulative depth from marginal quantity; adding cumulative levels double counts inventory. Confirm quantity/price basis and asset standard rather than equating every row with one unique NFT.
• Offer/listing eligibility, expiration, fees, balances, approvals, and execution can differ or be unreported. Keep observed quote/depth separate from evidence of a completed sale. Missing detail does not establish a valid fillable order.

sh

scripts/crawlora.sh /opensea/chains
scripts/crawlora.sh /opensea/search/collections query="art" limit=5
# Resolve a verified collection slug before:
# scripts/crawlora.sh "/opensea/collection/$SLUG/depth"
# scripts/crawlora.sh "/opensea/collection/$SLUG/activity" event_types=SALE limit=20

Compare depth with compatible measures

Use the same item/trait eligibility, timestamp, currency and price basis for bid/ask comparisons. ETH, WETH, stablecoins and source-provided USD estimates must not silently share one unit; any conversion needs a dated basis. Preserve source USD estimates separately from native amounts and execution costs. A floor ask and collection bid need not cover the same eligible item.

Holder rows represent wallet balances, not unique natural people or verified beneficial owners. A custodian/contract can hold for many users; several wallets can belong to one person. Holdings concentration requires compatible complete supply/balance denominators, not a top-N subtotal. Deduplicate sale events with transaction/event identity while retaining multi-item/bundle ambiguity and unknown price-per-item basis. Do not allege wash trading or manipulation solely from repeated addresses, outliers, or self-transfer-like patterns.

Return collection/contract identity, currency/time and coverage ledger, correctly interpreted ladders, sampled activity, holder/trait scope, and missing execution conditions. Do not predict resale value, declare investment quality, connect wallets, sign transactions, place offers, buy assets, or schedule monitoring from a snapshot research request.