Skip to content

Releases: ProjectOpenSea/api-types

v0.2.2

01 May 00:57

Choose a tag to compare

What's Changed

Patch release. Additive only — no breaking changes.

New traits query param on three collection-scoped GET endpoints

  • GET /api/v2/collection/{slug}/nfts
  • GET /api/v2/listings/collection/{slug}/best
  • GET /api/v2/events/collection/{slug}

Accepts a JSON-encoded array of {traitType, value} filters. Multiple entries are AND-combined server-side (returned items must match every trait). Empty result when no items match; 400 if a single trait matches more than 1000 items.

?traits=[{"traitType":"Background","value":"Red"}]

TokenBalanceResponse.status field

New optional enum field: OK | WARNING | SPAM | LOW_LIQUIDITY | LOW_VALUE. Surfaced when callers pass disable_spam_filtering=true on the account tokens endpoint, so they can see why a token would normally have been filtered.

Account tokens endpoint refinements

  • limit max raised from 25 → 100.
  • disable_spam_filtering description expanded to clarify what does and doesn't get surfaced.

Validation

Live tests against boredapeyachtclub confirmed end-to-end behavior across NFTs, listings, and events — including AND-combined traits, no-match → empty result, pagination with traits, and 400 on invalid JSON. Deployment monitoring shows zero listing-related errors and baseline error rate post-rollout.

Full Changelog: ProjectOpenSea/opensea-devtools@api-types-v0.2.1...api-types-v0.2.2

v0.2.1

21 Apr 01:01

Choose a tag to compare

What's Changed

Sync OpenAPI spec: add token-groups endpoints (GET /api/v2/token-groups, GET /api/v2/token-groups/{slug}) and instant API key provisioning (POST /api/v2/auth/keys). Exports new TokenGroup*, InstantApiKeyResponse, and RateLimitsResponse types. Non-breaking: some fields on IntervalStat and Total are now marked deprecated.

Full Changelog: ProjectOpenSea/opensea-devtools@api-types-v0.2.0...api-types-v0.2.1

v0.2.0

10 Apr 20:40

Choose a tag to compare

What's Changed

Initial release

  • Auto-generated TypeScript types from the OpenSea API OpenAPI spec
  • Drops endpoints, trending/top collections, account resolve schemas

Full Changelog: https://github.com/ProjectOpenSea/opensea-devtools/commits/api-types-v0.2.0