API Reference
Use Crawlora's OpenSea API endpoints to extract supported public OpenSea data as structured JSON. This documentation covers 36 active endpoints including List marketplace-wide OpenSea activity, List OpenSea's browse categories, List the chains OpenSea indexes, Get an OpenSea collection, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as slug, query, slugs, chain, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/%3Cslug%3E" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/opensea/activityapiKey2 credits/requestReturns the live cross-collection activity feed — every sale, listing, offer, transfer, and mint OpenSea indexes, newest first, with the collection each event belongs to. Filter with `event_types` for a marketplace-wide trade tape.
Required params: None
/opensea/categoriesapiKey1 credit/requestReturns OpenSea's category taxonomy as top-level groups and their child categories, with display names. The child slugs are the canonical category identifiers used across the marketplace.
Required params: None
/opensea/chainsapiKey1 credit/requestReturns every blockchain OpenSea indexes, with its identifier, display name, and architecture. The identifiers are the accepted values for the `chain` path parameter on the item endpoints.
Required params: None
/opensea/collection/{slug}apiKey2 credits/requestReturns public marketplace metadata and trading statistics for one NFT collection: name, description, imagery, verification flag, contract address and chain, social links, current floor price and top collection offer, plus lifetime and rolling one-hour/one-day/seven-day/thirty-day sales, volume, and floor-price change. Delisted and blacklisted collections return 404 rather than an empty payload.
Required params: slug:path
/opensea/collection/{slug}/activityapiKey2 credits/requestReturns a cursor-paginated feed of marketplace events for a collection — sales, listings, offers, transfers, mints, and collection/trait offers — with the counterparties, price, marketplace, and transaction hash. Filter with `event_types` to narrow the feed, for example `event_types=SALE` for a sales-only history.
Required params: slug:path
/opensea/collection/{slug}/best-dealsapiKey2 credits/requestReturns the listed items OpenSea surfaces as the best value in a collection, judged against each item's rarity and the collection floor. This is the curated "best deals" shelf from the collection page, not a generic price sort.
Required params: slug:path
/opensea/collection/{slug}/chartapiKey2 credits/requestReturns a time series for a collection — either its floor price or its traded volume — over the requested window, with each sample in both the settlement token and USD. Use `metric=floor_price` for the floor line and `metric=volume` for the volume bars.
Required params: slug:path
/opensea/collection/{slug}/depthapiKey2 credits/requestReturns the full bid/ask ladder for a collection: resting listings and offers grouped into price levels with the quantity available at each. This is the depth chart behind OpenSea's own collection page, and it is the fastest way to see how thin or deep the book is above the floor.
Required params: slug:path
/opensea/collection/{slug}/holdersapiKey2 credits/requestReturns a cursor-paginated leaderboard of wallets holding items in the collection, ranked by quantity held, with each holder's address and display name where OpenSea publishes one.
Required params: slug:path
/opensea/collection/{slug}/itemsapiKey2 credits/requestReturns a cursor-paginated page of NFTs in a collection with their traits, rarity rank, current owner, best standing listing, and last sale price. Pass `cursor` from `next_page_cursor` to page forward. Narrow the result set with `listed_only`, `traits`, a `min_price`/`max_price` band, or a `min_rarity`/`max_rarity` rank band — the filters combine, so `traits=Fur:Solid Gold&listed_only=true` returns only buyable Solid Gold apes.
Required params: slug:path
/opensea/collection/{slug}/offersapiKey2 credits/requestReturns the collection-wide offer book as price levels: how many standing offers sit at each price per item, plus the aggregate offer count and total value across the whole collection. Offers are sorted by price.
Required params: slug:path
/opensea/collection/{slug}/rarest-itemsapiKey2 credits/requestReturns the rarest items in a collection that currently have a standing listing, each with its rarity rank, traits, and asking price. Unlike the trait endpoints, this shelf is scoped to what is actually buyable right now.
Required params: slug:path
/opensea/collection/{slug}/search-itemsapiKey2 credits/requestRuns a keyword search scoped to one collection — matching on item name and trait values — and returns the hits with rarity rank and best standing listing. Narrower than `/opensea/collection/{slug}/items`, which lists everything.
Required params: slug:path, query:query
/opensea/collection/{slug}/social-proofapiKey2 credits/requestReturns how many accounts follow or watch a collection, plus the notable collectors OpenSea highlights for it. Useful as a demand signal alongside the trading stats.
Required params: slug:path
/opensea/collection/{slug}/top-salesapiKey2 credits/requestReturns the highest-value sales ever recorded for a collection, with the buyer, seller, price, and transaction hash for each. Unlike `/opensea/collection/{slug}/activity?event_types=SALE`, which is a reverse-chronological feed, this is ranked by sale price.
Required params: slug:path
/opensea/collection/{slug}/trait-offersapiKey2 credits/requestReturns standing offers scoped to a specific trait value rather than the whole collection, as price levels with the trait type and value attached. Useful for pricing rare-trait items against the collection floor.
Required params: slug:path
/opensea/collection/{slug}/traitsapiKey2 credits/requestReturns a cursor-paginated page of the collection's trait types and the values each takes, with per-value item counts where OpenSea publishes them. Numeric traits carry a comparison operator.
Required params: slug:path
/opensea/collectionsapiKey2 credits/requestResolves up to 50 collections in a single call from a comma-separated `slugs` list, returning each one's floor price, verification flag, headline stats, and per-marketplace listed-item counts. Use this instead of calling `/opensea/collection/{slug}` in a loop — it costs one upstream request regardless of how many slugs you pass. The `markets` array shows how many items are listed on OpenSea versus other marketplaces for the same collection.
Required params: slugs:query
/opensea/dropsapiKey2 credits/requestReturns the NFT drop calendar — either upcoming mints or recently minted drops — with each drop's contract, chain, and parent collection. Use `type=UPCOMING` to watch for launches and `type=RECENTLY_MINTED` for ones that just went live.
Required params: None
/opensea/item/{chain}/{contract_address}/{token_id}apiKey2 credits/requestReturns one NFT addressed by chain, contract address, and token id, including its traits, rarity rank, current owner, parent collection, best standing listing, and best standing offer. Call `/opensea/chains` for the accepted `chain` values.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/activityapiKey2 credits/requestReturns the marketplace event history for a single NFT — sales, listings, offers, transfers, and mints — with counterparties, price, and transaction hash. Filter with `event_types`, for example `event_types=SALE,TRANSFER` for an ownership trail.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/chartapiKey2 credits/requestReturns every indexed sale of one NFT with its timestamp and price, in both the settlement token and USD — the price history behind the chart on an item page. An item that has never sold returns an empty `points` list. For collection-level sale history use `/opensea/collection/{slug}/activity?event_types=SALE`.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/depthapiKey2 credits/requestReturns the bid/ask ladder for a single NFT: resting listings and offers grouped into price levels with the quantity at each. Useful for ERC-1155 items where many units trade at different prices.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/listingsapiKey2 credits/requestReturns every standing sell order for one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active listings returns an empty list rather than a 404.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/offersapiKey2 credits/requestReturns every standing bid on one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active offers returns an empty list rather than a 404.
Required params: chain:path, contract_address:path, token_id:path
/opensea/item/{chain}/{contract_address}/{token_id}/ownersapiKey2 credits/requestReturns the wallets holding one NFT plus the total owner count. ERC-721 items resolve to a single owner; ERC-1155 items can have many, each with the quantity held.
Required params: chain:path, contract_address:path, token_id:path
/opensea/most-watchedapiKey2 credits/requestReturns the collections most added to watchlists on OpenSea, with their current floor price and headline stats. A demand signal that leads trading volume, since watchlisting precedes buying.
Required params: None
/opensea/profile/{identifier}apiKey2 credits/requestReturns the public profile for a wallet, resolved from a wallet address, an ENS name, or an OpenSea username: display name, avatar and banner imagery, verification flag, and linked social handles. Wallet balances, portfolio value, and profit/loss are deliberately not exposed.
Required params: identifier:path
/opensea/profile/{identifier}/activityapiKey3 credits/requestReturns a cursor-paginated feed of a wallet's NFT marketplace events — sales, listings, offers, transfers, and mints — with the counterparty, price, and collection for each. Accepts a wallet address, ENS name, or OpenSea username. Scoped to NFT events only; token transfers and swaps are not returned.
Required params: identifier:path
/opensea/profile/{identifier}/collectionsapiKey3 credits/requestReturns the collections a wallet holds items in, with how many items it holds in each and that collection's current floor price. Useful for valuing a wallet's holdings collection by collection.
Required params: identifier:path
/opensea/profile/{identifier}/createdapiKey3 credits/requestReturns the collections a wallet created, as opposed to the ones it holds, each with its floor price and trading statistics. Use this to find a creator's full body of work from any one of their collections' contract deployer address.
Required params: identifier:path
/opensea/profile/{identifier}/itemsapiKey3 credits/requestReturns a cursor-paginated page of the NFTs held by a wallet, with each item's collection, rarity rank, and best standing listing. Accepts a wallet address, ENS name, or OpenSea username; a non-address identifier costs one extra resolution lookup.
Required params: identifier:path
/opensea/profile/{identifier}/search-itemsapiKey3 credits/requestRuns a keyword search across a wallet's holdings, matching on item and collection name, and returns the hits with rarity rank and best standing listing. Narrower than `/opensea/profile/{identifier}/items`, which lists everything the wallet holds.
Required params: identifier:path, query:query
/opensea/rankingsapiKey2 credits/requestReturns the collections on one of OpenSea's ranking boards for a given window, each with its ranking score, floor price, and rolling stats. `TRENDING` ranks by recent momentum, `TOP` by absolute volume, and `NEW` surfaces recently launched collections.
Required params: None
/opensea/search/collectionsapiKey2 credits/requestRuns a keyword search across OpenSea collections and returns the matches with floor price, verification flag, and headline stats. Use this to resolve a human-readable name to the `slug` the other collection endpoints take.
Required params: query:query
/opensea/top-moversapiKey2 credits/requestReturns the collections with the largest recent floor-price and volume moves, each with its current floor and rolling one-hour and one-day stats. Complements `/opensea/rankings`, which ranks by score rather than by change.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| List marketplace-wide OpenSea activity | /opensea/activity | GET | 2 credits/request | None | View docs | Try endpoint |
| List OpenSea's browse categories | /opensea/categories | GET | 1 credit/request | None | View docs | Try endpoint |
| List the chains OpenSea indexes | /opensea/chains | GET | 1 credit/request | None | View docs | Try endpoint |
| Get an OpenSea collection | /opensea/collection/{slug} | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's marketplace activity | /opensea/collection/{slug}/activity | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's best-value listings | /opensea/collection/{slug}/best-deals | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get an OpenSea collection's price or volume history | /opensea/collection/{slug}/chart | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get an OpenSea collection's order book | /opensea/collection/{slug}/depth | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's holders | /opensea/collection/{slug}/holders | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List items in an OpenSea collection | /opensea/collection/{slug}/items | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's offer book | /opensea/collection/{slug}/offers | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's rarest listed items | /opensea/collection/{slug}/rarest-items | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Search items inside an OpenSea collection | /opensea/collection/{slug}/search-items | GET | 2 credits/request | slug:path, query:query | View docs | Try endpoint |
| Get an OpenSea collection's social following | /opensea/collection/{slug}/social-proof | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's highest-value sales | /opensea/collection/{slug}/top-sales | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's trait offer book | /opensea/collection/{slug}/trait-offers | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| List an OpenSea collection's traits | /opensea/collection/{slug}/traits | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Look up several OpenSea collections at once | /opensea/collections | GET | 2 credits/request | slugs:query | View docs | Try endpoint |
| List the OpenSea drop calendar | /opensea/drops | GET | 2 credits/request | None | View docs | Try endpoint |
| Get a single OpenSea NFT | /opensea/item/{chain}/{contract_address}/{token_id} | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| List one OpenSea NFT's event history | /opensea/item/{chain}/{contract_address}/{token_id}/activity | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| Get an OpenSea NFT's sale-price history | /opensea/item/{chain}/{contract_address}/{token_id}/chart | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| Get an OpenSea NFT's order book | /opensea/item/{chain}/{contract_address}/{token_id}/depth | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| List standing listings for an OpenSea NFT | /opensea/item/{chain}/{contract_address}/{token_id}/listings | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| List standing offers for an OpenSea NFT | /opensea/item/{chain}/{contract_address}/{token_id}/offers | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| List the owners of an OpenSea NFT | /opensea/item/{chain}/{contract_address}/{token_id}/owners | GET | 2 credits/request | chain:path, contract_address:path, token_id:path | View docs | Try endpoint |
| List the most watchlisted OpenSea collections | /opensea/most-watched | GET | 2 credits/request | None | View docs | Try endpoint |
| Get a public OpenSea profile | /opensea/profile/{identifier} | GET | 2 credits/request | identifier:path | View docs | Try endpoint |
| List a wallet's NFT marketplace activity | /opensea/profile/{identifier}/activity | GET | 3 credits/request | identifier:path | View docs | Try endpoint |
| List the collections a wallet holds | /opensea/profile/{identifier}/collections | GET | 3 credits/request | identifier:path | View docs | Try endpoint |
| List the collections a wallet created | /opensea/profile/{identifier}/created | GET | 3 credits/request | identifier:path | View docs | Try endpoint |
| List the NFTs a wallet holds | /opensea/profile/{identifier}/items | GET | 3 credits/request | identifier:path | View docs | Try endpoint |
| Search the NFTs a wallet holds | /opensea/profile/{identifier}/search-items | GET | 3 credits/request | identifier:path, query:query | View docs | Try endpoint |
| List ranked OpenSea collections | /opensea/rankings | GET | 2 credits/request | None | View docs | Try endpoint |
| Search OpenSea collections by keyword | /opensea/search/collections | GET | 2 credits/request | query:query | View docs | Try endpoint |
| List the biggest movers on OpenSea | /opensea/top-movers | GET | 2 credits/request | None | View docs | Try endpoint |