Releases: ProjectOpenSea/api-types
v0.2.2
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}/nftsGET /api/v2/listings/collection/{slug}/bestGET /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
limitmax raised from 25 → 100.disable_spam_filteringdescription 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
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
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