# OpenSea integration

> NFT and token marketplace API: collections, NFTs, accounts, listings, offers, events, token data, swaps, and drops across 29 chains.

- Authentication: apiKey

## Tools (100)

- **[Beta] Get activity for a registered tool**: [Beta] Returns merged x402 payment events and usage reports for a tool, deduplicated by transaction hash. Each event includes an attribution field indicating confidence level. This endpoint is under active development and may change without notice.
- **[Beta] Get a registered tool**: [Beta] Get a registered tool by its composite key: registry chain, registry address, and tool ID. Includes pricing recipients and NFT collection info for gated tools. This endpoint is under active development and may change without notice.
- **[Beta] List registered tools**: [Beta] List verified registered tools with optional sorting and filtering. This endpoint is under active development and may change without notice.
- **[Beta] Report tool usage (metrics only)**: [Beta] Report verified tool usage for metrics and analytics purposes only.
- **[Beta] Search registered tools**: [Beta] Search for verified registered tools by name, tags, creator, or other criteria. This endpoint is under active development and may change without notice.
- **Build a criteria offer**: Build a portion of a criteria offer including the consideration item, zone, and zone hash needed to post an offer.
- **Build cross-chain mint transactions for a drop**: Returns an ordered list of transactions for minting a drop using a token on another chain. The payer signs each transaction in order, and the minter receives the NFT. After submission, pass receipt_request to POST /api/v2/transactions/receipt and poll until the status is terminal.
- **Build deploy contract transaction data**: Returns a ready-to-sign transaction that deploys a new drop contract.
- **Build mint transaction data for a drop**: Returns ready-to-sign transaction data for minting tokens from a drop.
- **Cancel an order**: Offchain cancel a single order, offer or listing, by its order hash when protected by the SignedZone.
- **Create a criteria offer**: Create a criteria offer to purchase any NFT in a collection or which matches the specified trait.
- **Create a listing**: List a single NFT (ERC721 or ERC1155) for sale on the OpenSea marketplace.
- **Create an instant API key**: Creates a free-tier API key instantly without authentication. The key can be used immediately for all API endpoints. Keys expire after 7 days.
- **Create an item offer**: Create an offer to purchase a single NFT (ERC721 or ERC1155).
- **Execute a token swap**: Get executable transactions for token-to-token swaps. Supports same-chain and cross-chain swaps with multiple from/to assets.
- **Fulfill a listing**: Retrieve all the information, including signatures, needed to fulfill a listing directly onchain.
- **Fulfill a listing using a different token**: Get fulfillment data to buy one or more listings using a token on a different chain or a different token on the same chain.
- **Fulfill an offer**: Retrieve all the information, including signatures, needed to fulfill an offer directly onchain. For trait offers with identifierOrCriteria '0', the server validates that the specified token matches the offer's trait criteria before generating fulfillment data.
- **Get account token activity**: Get paginated fungible token activity (transfers, swaps, wraps, and unwraps) for an account across all chains. Optionally filter by chain, token, and/or activity type.
- **Get active listings for an account**: Get a paginated list of active listings created by a wallet address.
- **Get active offers made by an account**: Get a paginated list of active offers made by a wallet address.
- **Get all listings by collection**: Get all listings for a collection.
- **Get all offers by collection**: Get all offers for a collection.
- **Get an OpenSea account profile**: Get an OpenSea Account Profile including details such as bio, social media usernames, and profile image.
- **Get an order**: Get a single order by its order hash.
- **Get a single collection**: Get a single collection including details such as fees, traits, and links.
- **Get a token group by slug**: Get detailed information about a specific token group by its slug identifier.
- **Get best listing by NFT**: Get the best listing for an NFT.
- **Get best listings by collection**: Get the best listings for a collection sorted by price ascending.
- **Get best offer by NFT**: Get the best offer for an NFT.
- **Get closed (realized) trading positions for an account**: Get a paginated, per-trade breakdown of a wallet's realized P&L. Each closed position reflects FIFO (first-in, first-out) cost-basis lot matching.
- **Get collection by NFT**: Get the collection that an NFT belongs to. This is useful for multi-contract collections like Art Blocks where the item ID disambiguates which collection the NFT belongs to.
- **Get collection floor price history**: Get time-series floor price data for a collection.
- **Get collection holders**: Get a paginated list of holders for a collection.
- **Get collection offer aggregates**: Get aggregated offer buckets grouped by price level for a collection.
- **Get collections by slugs**: Retrieve multiple collections in a single request by providing a list of slugs. Results are returned in the same order as the input slugs. Not-found collections are silently omitted.
- **Get collections owned by an account**: Get a paginated list of collections owned by a wallet address, with ownership data.
- **Get collection stats**: Get statistics for a collection including volume, floor price, and trading metrics.
- **Get collection traits**: Get all available traits for a collection with their value counts and data types.
- **Get contract**: Get contract metadata including collection information, contract standards, and ownership details.
- **Get creator fee enforcement**: Whether creator fees are enforced onchain for a collection through a transfer validator (ERC721-C), and whether its contract supports turning that on.
- **Get deploy contract receipt**: Check the status of a contract deployment transaction.
- **Get drop by collection slug**: Get detailed drop information for a collection, including stages and supply. `stages` is in the order the drop stores them, not sorted by start time. For a drop saved through POST /api/v2/drops/{slug} that puts the public stage first, although it runs last; sort by `start_time` for the schedule.
- **Get drops**: Get a list of NFT drops (mints) by type: featured, upcoming, or recently_minted. Results may be fewer than the requested limit due to post-fetch filtering.
- **Get events**: Get a list of events, with optional filtering by event type and time range.
- **Get events (by account)**: Get a list of events for an account.
- **Get events (by collection)**: Get a list of events for a collection. Optionally filter by traits to only return events for items matching the specified trait criteria.
- **Get events (by NFT)**: Get a list of events for a specific NFT.
- **Get filter facets for a collection group**: Get the values of each normalized attribute in a collection group with the number of matching NFTs. Each facet is narrowed by the filters of the other types, so a facet keeps listing all of its own values.
- **Get listing creation actions**: Returns the blockchain actions (approvals + Seaport order signing payload) needed to list one or more NFTs. This eliminates the need to construct Seaport orders manually.
- **Get listing fulfillment actions**: Returns the blockchain actions needed to fulfill a listing, for listings that cannot be fulfilled with Seaport calldata.
- **Get multiple collections**: Get a list of collections with filters and sorting options.
- **Get NFT**: Get metadata, traits, ownership information, and rarity for a single NFT.
- **Get NFT analytics**: Get analytics data for a specific NFT including sales history and floor price history.
- **Get NFT metadata**: Get detailed metadata for an NFT including name, description, image, traits, and external links.
- **Get NFT owners**: Get a paginated list of owners for a specific NFT. Particularly useful for ERC-1155 tokens which can have multiple owners.
- **Get NFTs by account**: Get all NFTs owned by a specific account on a blockchain, with optional collection filtering. Each NFT includes the quantity the account holds, which can exceed 1 for ERC-1155.
- **Get NFTs by collection**: Get NFTs in a specific collection.
- **Get NFTs by contract**: Get all NFTs for a specific contract address on a blockchain.
- **Get NFTs by identifiers**: Retrieve multiple NFTs in a single request by providing a list of identifiers (chain, contract address, and token ID). Not-found NFTs are silently omitted from the response.
- **Get offer creation actions**: Returns the blockchain actions needed to offer on an NFT, the offer-side counterpart of the listing actions endpoint.
- **Get offer fulfillment actions**: Returns the blockchain actions a seller needs to accept an offer, for offers that cannot be accepted with Seaport calldata.
- **Get offers by collection**: Get collection offers on a collection.
- **Get offers by NFT**: Get offers for an NFT.
- **Get offers received by an account**: Get a paginated list of offers received on items owned by a wallet address.
- **Get order cancellation actions**: Returns the blockchain actions needed to cancel an order onchain, for orders that cannot be cancelled offchain through the cancel endpoint.
- **Get payment token**: Get a payment token by chain and contract address.
- **Get portfolio net worth history for an account**: Get net worth time series data for a wallet address over a given timeframe.
- **Get portfolio stats for an account**: Get portfolio analytics including total value, NFT/token breakdown, and P&L for a wallet address over a given timeframe.
- **Get profile shelves**: Get the shelves for a public wallet address.
- **Get profiles using a collection NFT as their profile picture**: Only profiles with a verified (currently-owned) NFT profile picture from this collection are returned. Results are grouped by contract, then ordered by token ID as a string.
- **Get public agent ownership relationships for a profile**: Returns the account confirmed to own this one as its agent, and the accounts it is the confirmed owner of.
- **Get supported chains**: Get all supported blockchain chains with metadata including name, native currency symbol, swap support, and block explorer information.
- **Get swap quote**: Get a quote for swapping tokens, including price details and executable transaction data.
- **Get token balances by account**: Get fungible token balances for a specific wallet address. Returns quantity (in display units, not raw/wei), USD value, and token metadata for each token held.
- **Get token details**: Get detailed information about a specific token by chain and contract address.
- **Get token groups**: Get a paginated list of token groups sorted by market cap descending. Token groups represent equivalent currencies across different blockchains (e.g., ETH on Ethereum, Base, and Arbitrum are all in the "eth" token group).
- **Get token holders**: Get paginated list of holders for a specific token, including quantity held and USD value.
- **Get token liquidity pools**: Get liquidity pools for a specific token.
- **Get token OHLCV candles**: Get OHLCV (Open, High, Low, Close, Volume) candlestick data for a specific token.
- **Get token price history**: Get historical price data for a specific token.
- **Get tokens by contract identifiers**: Retrieve multiple tokens in a single request by providing a list of contract identifiers (chain and address). Not-found tokens are silently omitted from the response.
- **Get token swap activity**: Get paginated swap activity for a specific token on a given chain.
- **Get token trading activity stats**: Get materialized trade count, USD volume, and average trade size for a token.
- **Get token transfers for a wallet's position in a currency**: Get a paginated, transfer-level breakdown of a wallet's position in a single currency (identified by contract_address + chain). Combine `direction` and `transfer_type` to distinguish zero-cost acquisitions (airdrops, CEX transfers) from buys.
- **Get top collections**: Get top NFT collections ranked by various stats (sorted descending).
- **Get top tokens**: Get top tokens ranked by 24-hour trading volume. Returns established tokens with high market activity. Pass `sort_by` and `sort_direction` to order the same set of tokens differently.
- **Get trading P&L for an account**: Get aggregated realized and unrealized trading profit and loss across all currencies held by a wallet address.
- **Get trait floor prices**: Get the cheapest active listing for every trait value in a collection, in one request.
- **Get trait offers for a collection**: Get trait offers for a collection.
- **Get transaction receipt**: Get the receipt/status for a submitted transaction. Works for all transaction types including listing fulfillments, cross-chain buys, sweeps, offer fulfillments, and token swaps. Poll this endpoint after submitting transactions to check completion status.
- **Get trending collections**: Get a list of trending NFT collections sorted by sales activity over a specified timeframe.
- **Get trending tokens**: Get trending tokens based on OpenSea's trending score algorithm. Returns tokens with high momentum including memecoins and newly popular assets. Pass `sort_by` and `sort_direction` to order the same set of tokens differently.
- **Refresh NFT metadata**: Queue a metadata refresh for a specific NFT to update its information from the blockchain.
- **Resolve an account identifier**: Resolve an ENS name (e.g. vitalik.eth), OpenSea username, or wallet address to canonical account info including address, username, and ENS name.
- **Search across OpenSea**: Search across collections, tokens, NFTs, and accounts. Results are ranked by relevance.
- **Search NFTs across a collection group**: Search NFTs across every collection in a group, such as `trading_cards`, using normalized attributes that are consistent across issuers.
- **Sweep buy items from a collection**: Buy up to N items from a collection using any payment token, including cross-chain.
- **Transfer NFTs or tokens between wallets**: Returns ordered blockchain actions to execute for transferring one or more NFTs or tokens from one wallet to another. Supports bulk transfers of multiple assets in a single request.
- **Validate NFT metadata**: Fetch and validate NFT metadata directly from the blockchain without using cached data. Returns both original and processed (SeaDN) URLs to show how the metadata would be ingested. This endpoint does not persist any data.

Connect OpenSea in General Input: https://www.generalinput.com/apps/opensea