Developers

rare.market has a free public API for marketplace data and Rare OS. No email and no sign-up form: connect a Sui wallet, sign a message and get a key.

Your keys

Up to 5 keys per wallet. Use one per app so you can revoke them separately.

Connect a wallet to get an API key.

Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers.

Access	Per minute	Per day
Anonymous, per IP	60	20,000
Free API key	300	200,000

Over the limit you get a 429 with a Retry-After header and an error body with the code rate_limited.
Streams such as /notify/stream have a cap on open connections per IP or key.
Responses served from the edge cache do not count.

Send your key in the x-api-key header.

Without a key

curl https://rare.market/api/v1/collections?limit=5

With a key

curl -H "x-api-key: YOUR_KEY" https://rare.market/api/v1/collections?limit=5

Paths under /v1 that are in the spec are stable. Breaking changes ship under a new version.
Deprecated fields and routes stay for at least 90 days and are announced with Deprecation and Sunset headers.
Routes that are not in the spec are internal and can change without notice.