Open Sea

Learn how to use Open Sea with Composio

Overview

Enum

OPEN_SEA

Description

OpenSea is the world’s first and largest NFT marketplace for NFTs and crypto collectibles.

Authentication Details

api_key
stringRequired
base_url
stringDefaults to https://api.opensea.io/api/v2

Actions

Get metadata, traits, ownership information, and rarity for a single nft.

Action Parameters

address
stringRequired
chain
stringRequired
identifier
stringRequired

Action Response

data
object
successful
boolean
error

Refresh metadata for a single nft.

Action Parameters

address
stringRequired
chain
stringRequired
identifier
stringRequired

Action Response

data
object
successful
boolean
error

Get the best listing for an nft.

Action Parameters

collection_slug
stringRequired
identifier
stringRequired
include_private_listings
boolean

Action Response

data
object
successful
boolean
error

Get a smart contract for a given chain and address.

Action Parameters

address
stringRequired
chain
stringRequired

Action Response

data
object
successful
boolean
error

Build a portion of a criteria offer including the merkle tree needed to post an offer.

Action Parameters

offerer
stringRequired
quantity
integerDefaults to 1
criteria
objectRequired

Action Response

data
object
successful
boolean
error

Get stats for a single collection on opensea.

Action Parameters

collection_slug
stringRequired

Action Response

data
object
successful
boolean
error

Get an opensea account profile including details such as bio, social media usernames, and profile image.

Action Parameters

address_or_username
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve all the information, including signatures, needed to fulfill an offer directly onchain.

Action Parameters

offer
objectRequired

Action Response

data
object
successful
boolean
error

Offchain cancel a single order, offer or listing, by its order hash when protected by the signedzone. protocol and chain are required to prevent hash collisions. please note cancellation is only assured if a fulfillment signature was not vended prior to cancellation.

Action Parameters

chain
stringRequired
order_hash
stringRequired
protocol_address
stringRequired
offerer_signature
string

Action Response

data
object
successful
boolean
error

Get a smart contract for a given chain and address.

Action Parameters

address
stringRequired
chain
stringRequired

Action Response

data
object
successful
boolean
error

Get the complete set of active, valid listings.

Action Parameters

chain
stringRequired
protocol
stringRequired
asset_contract_address
string
cursor
string
limit
integerDefaults to 20
listed_after
string
listed_before
string
maker
string
order_by
stringDefaults to created_date
order_direction
stringDefaults to desc
payment_token_address
string
taker
string
token_ids
array

Action Response

data
object
successful
boolean
error

Get a single order, offer or listing, by its order hash. protocol and chain are required to prevent hash collisions.

Action Parameters

chain
stringRequired
order_hash
stringRequired
protocol_address
stringRequired

Action Response

data
object
successful
boolean
error

Get all active, valid offers for the specified collection. this includes individual and criteria offers.

Action Parameters

collection_slug
stringRequired
limit
integerDefaults to 100
next
string

Action Response

data
object
successful
boolean
error

Get all active, valid listings for a single collection.

Action Parameters

collection_slug
stringRequired
limit
integerDefaults to 100
next
string

Action Response

data
object
successful
boolean
error

List a single nft (erc721 or erc1155) for sale on the opensea marketplace.

Action Parameters

chain
stringRequired
protocol
stringRequired
parameters
objectRequired
signature
stringRequired
protocol_address
stringRequired

Action Response

data
object
successful
boolean
error

Create an offer to purchase a single nft (erc721 or erc1155).

Action Parameters

chain
stringRequired
protocol
stringRequired
parameters
objectRequired
signature
stringRequired
protocol_address
stringRequired

Action Response

data
object
successful
boolean
error

Create a criteria offer to purchase any nft in a collection or which matches the specified trait.

Action Parameters

protocol_data
objectRequired

Action Response

data
object
successful
boolean
error

Get the traits in a collection.

Action Parameters

collection_slug
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of opensea collections with optional filtering and pagination.

Action Parameters

chain
string
creator_username
string
include_hidden
boolean
limit
integerDefaults to 100
next
string
order_by
stringDefaults to created_date

Action Response

data
object
successful
boolean
error

Get a single collection including details such as fees, traits, and links.

Action Parameters

collection_slug
stringRequired

Action Response

data
object
successful
boolean
error

Retrieve all the information, including signatures, needed to fulfill a listing directly onchain.

Action Parameters

listing
objectRequired

Action Response

data
object
successful
boolean
error

Get a list of events from opensea based on various filters like timestamps and event types.

Action Parameters

after
integer
before
integer
event_type
array
limit
integerDefaults to 50
next
string

Action Response

data
object
successful
boolean
error