Open the complete API reference
Browse every operation, parameter, request body, response schema, auth rule,
status code, and cache note.
Start with the resource you need
Credentials
Most reads requireAPI-KEY. Creator and recovery writes require both
API-KEY and Authorization: Bearer <token> because the server also checks
the account’s linked wallets.
The public OpenSea metadata routes need no credential. Reports and platform
stats are Bearer-only. The reference marks these exceptions per operation.
Production integration rules
- Preserve Wei values as decimal strings until converting with a big-integer or decimal library.
- Treat cursor values as opaque and follow the returned cursor until it is absent.
- Expect short server caches on feeds and longer caches on stable metadata.
- Back off with jitter after
429; a missing or invalid API key deliberately uses the same status as an exhausted API-key quota. - Inspect body states on HTTP
200. Pending rarity, slug availability, readiness, refresh cooldowns, and missing receipts are not transport errors. - Persist draft IDs and deployment transaction hashes so creator flows can be resumed safely.