GET
Collections
List OpenSea collections with basic metadata.
/api/opensea/collections?chain=base&limit=6Public/demo route — check response
Open example ↗OPEN SEA DATA · HTTP API · x402
OpenSea endpoints
for AI agents.
A machine-readable gateway for NFT collections, listings, offers, activity, and wallet data. Open a protected demo endpoint in your browser to see the x402 paywall and connect a compatible wallet. A successful payment is only confirmed when the server verifies and settles it.
ENDPOINT DIRECTORY
Available routes
GET
Trending collections
Discover currently trending collections.
/api/opensea/trending?chain=ethereum&limit=10$0.02 / request (configured price)
Open example ↗GET
Top collections
Retrieve top-ranked collections.
/api/opensea/top-collections?chain=ethereum&limit=10$0.02 / request (configured price)
Open example ↗GET
Collection details
Get metadata and details for one collection.
/api/opensea/collection-details?slug=doodles-official$0.01 / request (configured price)
Open example ↗GET
Collection statistics
Fetch collection statistics and floor-price information.
/api/opensea/collection-stats?slug=doodles-official$0.02 / request (configured price)
Open example ↗GET
Floor prices
Request floor-price data for a collection.
/api/opensea/floor-prices?slug=doodles-official$0.02 / request (configured price)
Open example ↗GET
Collection listings
Fetch active listings for a collection.
/api/opensea/listings?slug=doodles-official$0.02 / request (configured price)
Open example ↗GET
Collection offers
Fetch offers associated with a collection.
/api/opensea/offers?slug=doodles-official$0.02 / request (configured price)
Open example ↗GET
Collection activity
Fetch collection events and sales activity.
/api/opensea/activity?slug=doodles-official$0.02 / request (configured price)
Open example ↗GET
NFT details
Fetch NFT metadata using a chain, contract address, and token ID.
/api/opensea/nft-details?chain=ethereum&contract=0x0000000000000000000000000000000000000000&token_id=1$0.01 / request (configured price)
Open example ↗GET
Wallet NFTs
List NFTs owned by a wallet address.
/api/opensea/wallet-nfts?address=0x0000000000000000000000000000000000000000&chain=ethereum$0.02 / request (configured price)
Open example ↗GET
Wallet portfolio
Request portfolio data for a wallet address.
/api/opensea/wallet-portfolio?address=0x0000000000000000000000000000000000000000$0.03 / request (configured price)
Open example ↗GET
Wallet listings
Fetch listings associated with a wallet.
/api/opensea/wallet-listings?address=0x0000000000000000000000000000000000000000$0.02 / request (configured price)
Open example ↗GET
Wallet offers
Fetch offers associated with a wallet.
/api/opensea/wallet-offers?address=0x0000000000000000000000000000000000000000$0.02 / request (configured price)
Open example ↗POST
Buy NFT (prepare transaction)
POST listing and buyer wallet details to request OpenSea fulfillment transaction data. Review and sign with your wallet; this endpoint does not buy automatically.
/api/opensea/buy-actions$0.02 / request (configured price)
View POST schema in OpenAPI ↗POST
Accept offer (prepare transaction)
POST offer, seller wallet, and NFT details to request transaction data for accepting an offer. Seller must review and sign.
/api/opensea/sell-actions$0.02 / request (configured price)
View POST schema in OpenAPI ↗POST
Create NFT listing
POST a Seaport order and signature created by the seller's wallet to submit a listing to OpenSea.
/api/opensea/listing-submit$0.02 / request (configured price)
View POST schema in OpenAPI ↗Service status
Public configuration status only; this does not prove facilitator availability or payment settlement.
Loading service status…Open /api/status ↗
x402 demo resource
Open the demo resource in a browser to view the wallet payment UI. Only a verified and settled payment should return the protected response.
/api/paidLive OpenSea data requires a valid server-side API key. Prices shown are configured/intended gateway prices, not confirmation that payment processing is currently operational. Never expose API keys in browser code.