OpenSea integration
OpenSea is the largest NFT marketplace, offering APIs to discover, fetch, and trade NFTs across Ethereum, Polygon, Solana, Arbitrum, Optimism, Base, and many more blockchains. The v2 API exposes NFT metadata, collection statistics, marketplace events (sales, listings, offers, transfers), Seaport-protocol orders for listing and offer creation, and account profiles. Authenticate every request with the x-api-key header (free tier available, 60 reads/min). Built on the Seaport protocol for trustless marketplace orders.
Say what should happen.
The workflow builds itself.
Common OpenSea use cases
- price-history charts
- marketplace integrations
- bidding bots
- floor-watch bots
- NFT activity tab
- trait filter UIs
- user activity feed
- display NFT in a UI
- floor sweeping bots
- sales-feed dashboards
What you can do with OpenSea
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Nft, 5 operations
get_nftGet nftGETGets a single NFT by chain, contract, and token id. Returns metadata, traits, owners, and rarity rank.list_nfts_by_accountList nfts by accountGETLists all NFTs owned by a given wallet address on a specific chain. Returns NFT metadata, contract, token id, and OpenSea URL.list_nfts_by_collectionList nfts by collectionGETLists NFTs that belong to an OpenSea collection identified by slug. Useful when a collection spans multiple contracts (e.g. game collections).list_nfts_by_contractList nfts by contractGETLists every NFT minted by a single contract on a given chain. Returns paged NFT metadata.refresh_nft_metadataRefresh nft metadataPOSTTriggers a metadata refresh for a single NFT. OpenSea re-fetches the on-chain tokenURI and updates its cached image, name, traits.
Event, 4 operations
list_eventsList eventsGETStreams marketplace events across every OpenSea collection. Filter by type and time window.list_events_by_accountList events by accountGETLists marketplace events a wallet was involved in (buys, sells, transfers, listings, offers).list_events_by_collectionList events by collectionGETLists historical marketplace events on a collection (sales, transfers, listings, offers).list_events_by_nftList events by nftGETLists historical marketplace events (sale, transfer, mint, listing, offer, trait_offer, collection_offer) for a single NFT.
Offer, 4 operations
build_offerBuild offerPOSTBuilds Seaport offer parameters for a collection (or trait) offer that the caller must then sign and submit via create_seaport_offer.create_seaport_offerCreate seaport offerPOSTCreates a new offer (bid) on an NFT, a collection, or a trait subset by posting a signed Seaport order.get_best_offer_by_nftGet best offer by nftGETGets the highest active offer on a single NFT (the best bid for one specific token).list_collection_offersList collection offersGETLists active collection-wide offers (any NFT in the collection accepts them). Returns order hash, price, remaining quantity, and Seaport data.
Listing, 3 operations
create_seaport_listingCreate seaport listingPOSTCreates a new sale listing for an NFT (ERC721 or ERC1155) by posting a signed Seaport order to OpenSea.get_best_collection_listingGet best collection listingGETGets the cheapest active listing on a collection (the floor). Convenience over sorting list_collection_listings by price.list_collection_listingsList collection listingsGETLists all active sale listings on a collection. Returns order hash, price, currency, chain, and Seaport protocol data.
Collection, 2 operations
get_collectionGet collectionGETGets a single OpenSea collection by slug, including fees, traits, social links, and contracts.list_collectionsList collectionsGETLists OpenSea collections with optional chain, creator, and ordering filters. Returns paged collection metadata.
Account, 1 operation
get_accountGet accountGETGets the OpenSea account profile (bio, profile/banner images, linked socials, joined date) by wallet address or username.
Collection stats, 1 operation
get_collection_statsGet collection statsGETGets all-time and interval-windowed trading stats for a collection: floor price, volume, number of owners, supply, and per-interval changes.
Trait, 1 operation
get_traitsGet traitsGETGets the trait taxonomy for a collection: every trait_type with the count of NFTs holding each value.
Use OpenSea from Claude Code, Cursor or Codex
Connect OpenSea in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its OpenSea operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect OpenSea
- Create your workspace
Sign up free. Nothing to install.
- Connect OpenSea once
Add your OpenSea connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
OpenSea integration FAQ
What can you do with the OpenSea integration?
LiveContext exposes 21 operations on OpenSea, covering nft, event, offer and listing. Common uses include price-history charts, marketplace integrations and bidding bots.
