Quickstart

Get an API key and make your first request in 30 seconds.

Quickstart

1. Get an API key

   curl -X POST https://api.gimme.fast/v1/keys \
     -H "Content-Type: application/json" \
     -d '{"name": "my-app"}'
   

   Save the gf_... key from the response — it can’t be retrieved again.

2. Fetch active markets

   curl

   curl https://api.gimme.fast/v1/markets?active=true \
     -H "X-API-Key: gf_your_key_here"
   
3. Get a live price

   curl

   curl https://api.gimme.fast/v1/price/TOKEN_ID \
     -H "X-API-Key: gf_your_key_here"
   

   Response

   {
     "token_id": "21742633143463...",
     "price": "0.72",
     "volume_24h": "15234.50",
     "change_24h": "+3.45",
     "complement_price": "0.28"
   }
   
4. Stream live trades

   wscat

   wscat -c "wss://ws.gimme.fast/ws?api_key=gf_your_key_here"
   > {"action": "subscribe", "channel": {"type": "trades"}}
   

Base URLs

Service	URL
REST API	https://api.gimme.fast/v1
WebSocket	wss://ws.gimme.fast/ws
Docs	https://gimme-fast.mintlify.app
Swagger UI	https://api.gimme.fast/docs

Rate Limits

Scope	Limit
read	1,000 req/min
write	2,000 req/min
admin	5,000 req/min

Need more? Get in touch.

Next Steps

Authentication

Key scopes, rotation, revocation, and security details.

Key Concepts

Understand markets, tokens, trades, and how Polymarket works on-chain.

WebSocket Guide

Subscriptions, compression, reconnection, and best practices.

API Reference

Full endpoint documentation.