OpenSea NFT API Python 3 wrapper
This an API wrapper library for the OpenSea API written in Python 3.
The library provides a simplified interface to fetch a diverse set of NFT data points from OpenSea.
Supported endpoints
The wrapper covers all of the OpenSea API endpoints (as of 2021-10-07, NOT including the Orderbook and Rinkeby API):
- Single asset (/asset)
- Single asset contract (/asset_contract)
- Single collection (/collection)
- Collection stats (/collection/{slug}/stats)
- Multiple assets (/assets)
- Multiple collections (/collections)
- Multiple events (/events)
- Multiple bundles (/bundles)
Installation
Install with pip:
pip install opensea-api
Usage
Get data about a single asset
from opensea import Asset
api = Asset(asset_contract_address="0x495f947276749Ce646f68AC8c248420045cb7b5e",
token_id="66406747123743156841746366950152533278033835913591691491127082341586364792833")
print(api.fetch())
Get data about a single asset contract
from opensea import Contract
api = Contract(asset_contract_address="0x495f947276749Ce646f68AC8c248420045cb7b5e")
print(api.fetch())
Get data about a single collection
from opensea import Collection
api = Collection(collection_slug="cryptopunks")
print(api.fetch())
Get collection stats
from opensea import CollectionStats
api = CollectionStats(collection_slug="cryptopunks")
print(api.fetch())
Get data about multiple assets
This example fetches three NFTs that Snoop Dogg owns:
from opensea import Assets
api = Assets()
print(api.fetch(owner="0xce90a7949bb78892f159f428d0dc23a8e3584d75",
limit=3))
Get data about multiple collections
This example creates a JSON file with 3 collections where Snoop Dogg is an owner:
from opensea import Collections
api = Collections()
print(api.fetch(asset_owner="0xce90a7949bb78892f159f428d0dc23a8e3584d75",
limit=3,
export_file_name='snoop_collections.json'))
Get data about multiple events
This example creates a JSON file with 10 events that happened between the defined time period (UTC timezone) between 2021-11-06 14:25 and 2021-11-06 14:30
from opensea import Events
from opensea import utils
api = Events()
period_start = utils.datetime_utc(2021, 11, 6, 14, 25)
period_end = utils.datetime_utc(2021, 11, 6, 14, 30)
print(api.fetch(occurred_after=period_start,
occurred_before=period_end,
limit=10,
export_file_name='events.json'))
Get data about multiple bundles
from opensea import Bundles
api = Bundles()
print(api.fetch(limit=3))
Documentation
- Wrapper documentation (work in progress)
- OpenSea API documentation
4 Aug 11, 2021
5 Jun 16, 2022
2 Jun 29, 2022
70 Jan 02, 2023
6 Nov 03, 2022
2 Jan 17, 2022
2 Feb 10, 2022
2 Dec 18, 2021
![Risky [ Zero Tow ]](https://avatars.githubusercontent.com/u/76860656?v=4&s=60)
11 Aug 30, 2022
95 Nov 11, 2022
3 Oct 27, 2022
828 Dec 28, 2022
4 Feb 27, 2022
319 Aug 15, 2022
400 Dec 19, 2022
2 Apr 22, 2022
3 Dec 16, 2021
23 Nov 09, 2022
49 Dec 31, 2022
15 Dec 15, 2021