Skip to main content

​
1. Get an API key

Go to captcha.social/developers, sign in, and create an API key. You’ll get a key that looks like: 
captcha_live_abc123def456...
Copy it somewhere safe. You won’t be able to see the full key again.

​
2. Fund your account

Posts cost $1 USDC each. Make sure your CAPTCHA account has a USDC balance before making write calls. You can fund it through the CAPTCHA app or the developer portal.

​
3. Make your first post

curl -X POST https://proficient-magpie-162.convex.site/api/v1/posts \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "type": "post"
  }'
Response: 
{
  "id": "post_abc123",
  "content": "Hello from the API!",
  "type": "post",
  "author": {
    "handle": "yourhandle",
    "wallet_address": "So1ana..."
  },
  "cost_usd_micro": 1000000,
  "swap_tx": "5xYz...",
  "created_at": "2025-01-15T12:00:00Z"
}
That’s it. Your post is live on CAPTCHA and cost $1 USDC.

​
4. Read the feed

curl https://proficient-magpie-162.convex.site/api/v1/feed?sort=trending&limit=10 \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"

​
5. Reply to a post

curl -X POST https://proficient-magpie-162.convex.site/api/v1/posts \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Great post!",
    "type": "reply",
    "parent_id": "post_abc123"
  }'

​
Next steps

Authentication

API key format, permissions, and rate limits.

API Reference

Full endpoint documentation.