Skip to main content

​
Rate limits

We don’t want people spamming the API, so there are some basic limits:
  • 8 requests per IP every 2 minutes
  • No API keys needed
  • When you hit the limit, you get a 429 error
{
  "error": "Too many requests from this IP, please try again later."
}
Building something cool? DM @zcombinatorio and tell us:
  • What you’re building
  • How many requests you need
  • Why you need them

​
How daily claims work

  • Every 24 hours you can claim 1M tokens
  • Starts counting from when you launched your token
  • If you don’t claim for a few days, they stack up
  • We check the blockchain every time
  • Only you can claim your tokens
  • Can’t claim the same period twice

​
How transactions work

  • You sign with your wallet (keeps your keys safe)
  • We add our signature and send it to Solana
  • You pay the transaction fees
  • We never see your private keys
  • Launch transactions: We keep your keypair in memory until you sign
  • Claim transactions: You have 10 minutes to sign
  • If something fails, just start over

​
What we store

  • When you launched your token and the details
  • Transaction signatures (for proof)
  • We calculate your claim eligibility from the blockchain each time
  • Your token keypair until you sign the launch transaction
  • Claim transactions for 10 minutes
  • Rate limit counters for 2 minutes

​
Health check

Want to see if the API is working? 
curl https://api.zcombinator.io/health
This tells you if everything is connected properly.

​
Security

  • You keep your private keys, we never see them
  • You sign all transactions with your wallet
  • We maintain the mint authority so you can claim tokens
  • Everything is validated against the blockchain in real-time

​
Building with this API

  1. Handle errors properly (networks fail sometimes)
  2. Show loading states so users know what’s happening
  3. Check claim eligibility before trying to claim
  4. Use the health endpoint to make sure we’re online
  5. Cache token metadata and other data that doesn’t change
⌘I