Developer
Portal.
Build on the SYBI data layer. Access all the data used to power Sybi in your apps today. Request any additions that could be helpful.
Birb Game Data
Live game state, seasons, rounds, and player activity.
Ownership Data
Wallet ownership and holdings across Moonbirds collections.
Asset Information
Metadata and attributes for Moonbirds assets.
Get an API Key
The SYBI API uses bearer tokens. Keys are manually issued for now, so in order to gain access there's a few small steps to take.
- Follow @soyouboughtit on X
- Send a DM explaining what you want the API token for and what you are planning on building
- Receive your API key via DMs once your request is reviewed
Overview
The SYBI API is a read-only JSON REST API for Moonbirds ecosystem data — collections, wallet ownership, Birb Game rounds, and live nesting stats. All routes live under https://api.soyouboughtit.app/v1.
Rate limits
429 Too Many Requests response also includes Retry-After in seconds.X-RateLimit-Limit: 60 X-RateLimit-Remaining: 57 X-RateLimit-Reset: 1716678901 Retry-After: 42 // only on 429
Errors
error field and the appropriate HTTP status. Status codes used: 400 bad input, 401 missing or invalid key, 404 not found, 429 rate-limited, 500 server error.// 400 example
{ "error": "Invalid Ethereum address" }
// 401 example
{ "error": "Invalid token" }
// 404 example
{ "error": "Token not found" }
// 429 example
{ "error": "Rate limit exceeded" }
// 500 example
{ "error": "Internal server error" }Get an API Key
The SYBI API uses bearer tokens. Keys are manually issued for now, so in order to gain access there's a few small steps to take.
- Follow @soyouboughtit on X
- Send a DM explaining what you want the API token for and what you are planning on building
- Receive your API key via DMs once your request is reviewed