Gamma API

Polymarket Gamma API ist die öffentliche REST-API, die marktbezogene Daten bereitstellt: Märkte, Events, Tags, Serien und Profile. Entwickler:innen und Trader:innen nutzen sie, um Märkte aufzulisten, Event-Metadaten abzurufen und Indexseiten oder Marktverzeichnisse ohne Authentifizierung zu bauen.

Wesentliche Erkenntnisse

• Die Gamma API ist öffentlich und erfordert keine Authentifizierung für Lesezugriffe. Verwenden Sie sie, um Märkte, Events, Tags, Serien und Profile aufzulisten.
• /markets ist rate-limitiert: 300 Anfragen pro 10 Sekunden. Die Paginierung verwendet cursor-basiertes after_cursor (offset wird abgelehnt).
• Nützliche Query-Parameter sind limit (max. 1000), after_cursor, Filter-Arrays wie slug oder condition_ids und boolesche Flags wie closed oder active.
• Kombinieren Sie /markets und /events mit Vorsicht: das kombinierte Listing-Limit beträgt 900 req / 10 s; das gesamte API-Limit ist 4000 req / 10 s.

Wie die Gamma API genutzt wird

Die Gamma API ist die kanonische öffentliche Oberfläche für darstellungsorientierte Daten zu Polymarket-Märkten. Frontends, Aggregatoren und Research-Tools rufen Endpunkte wie /markets und /events auf, um Marktlisten, Kategorieseiten und Tag-Filter zu füllen.

Wichtige Parameter und Verhaltensweisen

• limit: Steuert die Seitengröße. Standard ist 20, maximal 1000.
• after_cursor: Cursor-basierte Paginierung; offset wird mit HTTP 422 abgelehnt—verwenden Sie keine Offsets.
• Filter: Mehrere Query-Parameter akzeptieren Arrays (z. B. slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Flags: closed (Standard false), active und archived filtern nach Marktstatus.
• Sortierung: Der order-Parameter akzeptiert eine komma-getrennte Feldliste (z. B. volume24hr,volume,liquidity,endDate), kombiniert mit ascending (boolean).

Rate-Limits und praktische Hinweise

• Spezifisches Limit für /markets: 300 Anfragen pro 10 Sekunden.
• Kombiniertes Listing-Limit für /markets + /events: 900 Anfragen pro 10 Sekunden.
• Gesamte Gamma API-Oberfläche: 4000 Anfragen pro 10 Sekunden.

Wenn Sie ein hochfrequentiertes Indexing planen, implementieren Sie exponentielles Backoff und respektieren Sie das cursor-basierte Paging. Cachen Sie Listen, wenn sinnvoll; vermeiden Sie aggressives Polling der gleichen Ressource.

Example request (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

Im Kontext von Polymarket

Gamma ist die öffentliche, nicht authentifizierte Lese-API, die Sie abfragen, wenn Sie Marktmetadaten für UI-Listen, Tag-Seiten oder Integrationen benötigen, die keinen On-Chain-Status brauchen (für On-Chain-Positionen und Trades nutzen Sie die Data API; für Order-Book-Operationen die CLOB API). Da Gamma read-only und öffentlich ist, ist es der richtige Platz, um Marktverzeichnisse und Explorations-Tools aufzubauen.

Siehe auch

• /glossary/data-api
• /glossary/clob-api

Schlussbemerkung

Polymarket Gamma API ist die erste Anlaufstelle für Marktmetadaten. Verwenden Sie die dokumentierten Parameter und halten Sie sich an die Rate-Limits, um abgelehnte Anfragen zu vermeiden.