ankushkun / opensea

python wrapper for opensea api

Opensea API

An API wrapper library for opensea api.

Installation

pip3 install opensea

Usage

Retrieving assets:

from opensea import get_assets

# This will return a list of assets which you can iterate and get the needed data
asset_list = get_assets(limit=10, verified_only=False)

asset = asset_list[0] # Get the first asset obejct from the list

print(asset.name)
print(asset.description)
print(asset.asset_url)
print(asset.get_floor_price()) # Floor price of the collection

Retrieving bundles:

from opensea import get_bundles

# This will return a list of assets which you can iterate and get the needed data
bundles_list = get_bundles(limit=10)

bundle = bundles_list[0] # Get the first asset obejct from the list

print(bundle.slug)
print(bundle.assets[0].name)

Retrieving stats from specific collection:

from opensea import get_collection_stats

# This will return a CollectionStats Object
stats = get_collection_stats(collection="doodles-official")

print(stats.count)
print(stats.num_owners)
print(stats.floor_price)

opensea's Issues

When will implement sell on OpenSea functionality in this API wrapper?

Hello,

I'm MB. A very nice and polite guy.

When will you implement sell on OpenSea functionality in this API wrapper?

How to get the specific collection's floor price?

I tried to get a specific collection's floor price but can't find a way.

Let's say Cryptoadz, the contract address is here: '0x1cb1a5e65610aeff2551a50f76a87a7d3fb649c6'

How can I get its floor price?

Thanks.

Retrieving bundles

I would like to add Bundles to this repository, is that feature welcome? Looking at the source code, I found this comment:

    def get_assets(self, owner: str = "", order_by: str = "pk", order_direction: str = "asc", limit: int = 10, verified_only: bool = False):
        #                                                  ^^
        # I dunno what this 'pk' stands for but I think its the default for fastest ordering

So, to answer your question, pk stands for Primary Key and it is usually used with id field in databases (in this case, it means there is no ordering, that's why it is fast).