# OpenSea SDK

TypeScript SDK for the OpenSea marketplace

Repository: https://github.com/ProjectOpenSea/opensea-sdk
Canonical: https://ross.abutalabs.com/products/opensea-sdk
Homepage: https://docs.opensea.io/reference
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-23T19:03:49+00:00
Link (homepage): https://docs.opensea.io/reference
Link (site_page): https://docs.opensea.io/docs
Link (site_page): https://docs.opensea.io/changelog
Link (site_page): https://docs.opensea.io/docs/logos

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 2967, "days_push": 10, "days_rel": 10, "gap_med": 3.0, "n_releases_24m": 71}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2337, forks 1020 (observed 2026-08-28T04:06:38.073060+00:00)

## What it is
The official TypeScript SDK for OpenSea, the largest NFT marketplace. It lets developers access the orderbook, create and fulfill listings and offers, complete trades programmatically, and swap tokens across chains.

## Use cases
- create NFT listings and offers programmatically
- fulfill OpenSea orders onchain from a bot
- query the OpenSea orderbook and filter NFT listings
- fetch collection stats like floor price and volume
- build an NFT trading bot for OpenSea
- swap tokens across chains via OpenSea
- mint and deploy NFT contracts

## When to choose
- you want to build on the OpenSea marketplace with an official, maintained SDK
- you need programmatic order creation and fulfillment on Ethereum and other supported chains
- you prefer TypeScript/JavaScript with ethers.js or viem integration

## When to avoid
- you need a marketplace-agnostic NFT solution not tied to OpenSea
- you work in a language other than JavaScript/TypeScript
- you only need read-only NFT data without trading, where a simple API client may suffice

## Facets
- artifact type: library
- maturity: active
- function: sdk, http-client, api-framework, blockchain
- domain: blockchain, apis, developer-tools, web-development
- platform: cross-platform
- tags: nft, opensea, marketplace, trading, seaport, ethereum, web3, orderbook, nft-marketplace, token-swaps, cryptocurrency, nodejs, typescript

## Member repositories
- ProjectOpenSea/opensea-sdk (main) score 95
- ProjectOpenSea/opensea-creatures (examples) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:38.073060+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:37:34.427339+00:00, confidence not recorded.
  - readme: https://github.com/ProjectOpenSea/opensea-sdk (fetched 2026-08-28T04:06:38.073060+00:00, sha 9bb63894e98e)
  - homepage: https://docs.opensea.io/reference (fetched 2026-08-29T10:18:35.930743+00:00, sha 5a6bb6e88073)
  - site_page: https://docs.opensea.io/docs (fetched 2026-08-29T10:18:35.939900+00:00, sha cab867913879)
  - site_page: https://docs.opensea.io/changelog (fetched 2026-08-29T10:18:35.941706+00:00, sha bb2e7ab80a07)
  - site_page: https://docs.opensea.io/docs/logos (fetched 2026-08-29T10:18:35.943484+00:00, sha f164edaab8ac)
- Data as of 2026-08-30T08:39:29.467469+00:00.