sim/apps/docs/content/docs/de/tools/polymarket.mdx

---
title: Polymarket
description: Zugriff auf Prognosemarktdaten von Polymarket
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="polymarket"
  color="#4C82FB"
/>

{/* MANUAL-CONTENT-START:intro */}
[Polymarket](https://polymarket.com) ist eine dezentralisierte Plattform für Prognosemärkte, auf der Nutzer mit Blockchain-Technologie auf den Ausgang zukünftiger Ereignisse handeln können. Polymarket bietet eine umfassende API, die Entwicklern und Agenten den Zugriff auf Live-Marktdaten, Ereignislisten, Preisinformationen und Orderbuch-Statistiken ermöglicht, um datengesteuerte Workflows und KI-Automatisierungen zu unterstützen.

Mit der API von Polymarket und der Sim-Integration können Sie Agenten befähigen, programmatisch Informationen zu Prognosemärkten abzurufen, offene Märkte und zugehörige Ereignisse zu erkunden, historische Preisdaten zu analysieren und auf Orderbücher und Markt-Mittelwerte zuzugreifen. Dies schafft neue Möglichkeiten für Recherchen, automatisierte Analysen und die Entwicklung intelligenter Agenten, die auf Echtzeit-Ereigniswahrscheinlichkeiten reagieren, die aus Marktpreisen abgeleitet werden.

Zu den wichtigsten Funktionen der Polymarket-Integration gehören:

- **Marktlisting & Filterung:** Auflistung aller aktuellen oder historischen Prognosemärkte, Filterung nach Tags, Sortierung und Seitenweise Durchblättern der Ergebnisse.
- **Marktdetails:** Abrufen von Details für einen einzelnen Markt anhand der Markt-ID oder des Slugs, einschließlich seiner Ergebnisse und Status.
- **Ereignislisten:** Zugriff auf Listen von Polymarket-Ereignissen und detaillierte Ereignisinformationen.
- **Orderbuch- & Preisdaten:** Analyse des Orderbuchs, Abruf der aktuellen Marktpreise, Einsicht in den Mittelwert oder Erhalt historischer Preisinformationen für jeden Markt.
- **Automatisierungsbereit:** Erstellen von Agenten oder Tools, die programmatisch auf Marktentwicklungen, sich ändernde Quoten oder bestimmte Ereignisausgänge reagieren.

Durch die Nutzung dieser dokumentierten API-Endpunkte können Sie die umfangreichen On-Chain-Prognosemarktdaten von Polymarket nahtlos in Ihre eigenen KI-Workflows, Dashboards, Recherchetools und Handelsautomatisierungen integrieren.
{/* MANUAL-CONTENT-END */}

## Nutzungsanweisungen

Integrieren Sie Polymarket-Prognosemärkte in den Workflow. Kann Märkte, Markt, Ereignisse, Ereignis, Tags, Serien, Orderbuch, Preis, Mittelpunkt, Preisverlauf, letzten Handelspreis, Spread, Tick-Größe, Positionen, Trades und Suche abrufen.

## Tools

### `polymarket_get_markets`

Rufen Sie eine Liste von Prognosemärkten von Polymarket mit optionaler Filterung ab

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `closed` | string | Nein | Nach geschlossenem Status filtern \(true/false\). Verwenden Sie false für nur aktive Märkte. |
| `order` | string | Nein | Sortierfeld \(z.B. volumeNum, liquidityNum, startDate, endDate, createdAt\) |
| `ascending` | string | Nein | Sortierrichtung \(true für aufsteigend, false für absteigend\) |
| `tagId` | string | Nein | Nach Tag-ID filtern |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Marktdaten und Metadaten |

### `polymarket_get_market`

Rufen Sie Details eines bestimmten Prognosemarktes nach ID oder Slug ab

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `marketId` | string | Nein | Die Markt-ID. Erforderlich, wenn Slug nicht angegeben wird. |
| `slug` | string | Nein | Der Markt-Slug \(z.B. "will-trump-win"\). Erforderlich, wenn marketId nicht angegeben wird. |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Marktdaten und Metadaten |

### `polymarket_get_events`

Ruft eine Liste von Events von Polymarket mit optionaler Filterung ab

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `closed` | string | Nein | Nach geschlossenem Status filtern \(true/false\). Verwenden Sie false für nur aktive Ereignisse. |
| `order` | string | Nein | Sortierfeld \(z.B. volume, liquidity, startDate, endDate, createdAt\) |
| `ascending` | string | Nein | Sortierrichtung \(true für aufsteigend, false für absteigend\) |
| `tagId` | string | Nein | Nach Tag-ID filtern |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Event-Daten und Metadaten |

### `polymarket_get_event`

Ruft Details eines bestimmten Events nach ID oder Slug ab

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | Nein | Die Event-ID. Erforderlich, wenn kein Slug angegeben wird. |
| `slug` | string | Nein | Der Event-Slug \(z.B. "2024-presidential-election"\). Erforderlich, wenn keine eventId angegeben wird. |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Event-Daten und Metadaten |

### `polymarket_get_tags`

Verfügbare Tags zum Filtern von Märkten von Polymarket abrufen

#### Input

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Tag-Daten und Metadaten |

### `polymarket_search`

Nach Märkten, Ereignissen und Profilen auf Polymarket suchen

#### Input

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `query` | string | Ja | Suchbegriff |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `success` | boolean | Erfolgsstatus der Operation |
| `output` | object | Suchergebnisse und Metadaten |

### `polymarket_get_series`

Serien (verwandte Marktgruppen) von Polymarket abrufen

#### Input

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `series` | array | Array von Serien-Objekten |

### `polymarket_get_series_by_id`

Eine bestimmte Serie (zugehörige Marktgruppe) anhand der ID von Polymarket abrufen

#### Input

| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `seriesId` | string | Ja | Die Serien-ID |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `series` | object | Serien-Objekt mit Details |

### `polymarket_get_orderbook`

Die Orderbuch-Zusammenfassung für einen bestimmten Token abrufen

#### Input

| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID (aus den clobTokenIds des Marktes) |

#### Output

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `orderbook` | object | Orderbuch mit Geld- und Briefkurs-Arrays |

### `polymarket_get_price`

Den Marktpreis für einen bestimmten Token und eine bestimmte Seite abrufen

#### Input

| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID (aus den clobTokenIds des Marktes) |
| `side` | string | Ja | Orderseite: buy oder sell |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `price` | string | Marktpreis |

### `polymarket_get_midpoint`

Abrufen des Mittelpreises für einen bestimmten Token

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID (aus market clobTokenIds) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `midpoint` | string | Mittelkurs |

### `polymarket_get_price_history`

Abrufen historischer Preisdaten für einen bestimmten Markttoken

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID (aus market clobTokenIds) |
| `interval` | string | Nein | Zeitraum, der zum aktuellen Zeitpunkt endet (1m, 1h, 6h, 1d, 1w, max). Schließt sich gegenseitig mit startTs/endTs aus. |
| `fidelity` | number | Nein | Datenauflösung in Minuten (z.B. 60 für stündlich) |
| `startTs` | number | Nein | Startzeitstempel (Unix-Sekunden UTC) |
| `endTs` | number | Nein | Endzeitstempel (Unix-Sekunden UTC) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `history` | array | Array von Preisverlaufseinträgen mit Zeitstempel \(t\) und Preis \(p\) |

### `polymarket_get_last_trade_price`

Den letzten Handelspreis für einen bestimmten Token abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `price` | string | Letzter Handelspreis |

### `polymarket_get_spread`

Die Geld-Brief-Spanne für einen bestimmten Token abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `spread` | object | Geld-Brief-Spanne mit Geld- und Briefkursen |

### `polymarket_get_tick_size`

Die minimale Tickgröße für einen bestimmten Token abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | Ja | Die CLOB-Token-ID \(aus market clobTokenIds\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `tickSize` | string | Minimale Tick-Größe |

### `polymarket_get_positions`

Benutzerpositionen von Polymarket abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `user` | string | Ja | Wallet-Adresse des Benutzers |
| `market` | string | Nein | Optionale Markt-ID zum Filtern von Positionen |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `positions` | array | Array von Positions-Objekten |

### `polymarket_get_trades`

Handelshistorie von Polymarket abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `user` | string | Nein | Wallet-Adresse des Benutzers zum Filtern von Trades |
| `market` | string | Nein | Markt-ID zum Filtern von Trades |
| `limit` | string | Nein | Anzahl der Ergebnisse pro Seite \(max 50\) |
| `offset` | string | Nein | Paginierungsoffset \(überspringe diese Anzahl an Ergebnissen\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `trades` | array | Array von Handelsobjekten |

## Hinweise

- Kategorie: `tools`
- Typ: `polymarket`

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `user` | string | Ja | Wallet-Adresse des Benutzers \(mit 0x-Präfix\) |
| `limit` | string | Nein | Maximale Anzahl zurückzugebender Ergebnisse \(z. B. „50"\). Standard: 100, max: 500. |
| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung \(z. B. „100"\). Standard: 0, max: 10000. |
| `market` | string | Nein | Durch Komma getrennte Condition-IDs \(z. B. „0x1234...abcd,0x5678...efgh"\). Schließt sich gegenseitig mit eventId aus. |
| `eventId` | string | Nein | Durch Komma getrennte Event-IDs \(z. B. „12345,67890"\). Schließt sich gegenseitig mit market aus. |
| `type` | string | Nein | Aktivitätstyp-Filter: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, MAKER_REBATE |
| `start` | number | Nein | Start-Zeitstempel \(Unix-Sekunden\) |
| `end` | number | Nein | End-Zeitstempel \(Unix-Sekunden\) |
| `sortBy` | string | Nein | Sortierfeld: TIMESTAMP, TOKENS oder CASH \(Standard: TIMESTAMP\) |
| `sortDirection` | string | Nein | Sortierrichtung: ASC oder DESC \(Standard: DESC\) |
| `side` | string | Nein | Trade-Seiten-Filter: BUY oder SELL \(gilt nur für Trades\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `activity` | array | Array von Aktivitätseinträgen |
|   ↳ `proxyWallet` | string | Proxy-Wallet-Adresse des Benutzers |
|   ↳ `timestamp` | number | Unix-Zeitstempel der Aktivität |
|   ↳ `conditionId` | string | Markt-Condition-ID |
|   ↳ `type` | string | Aktivitätstyp \(TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION\) |
|   ↳ `size` | number | Größe in Token |
|   ↳ `usdcSize` | number | Größe in USDC |
|   ↳ `transactionHash` | string | Blockchain-Transaktions-Hash |
|   ↳ `price` | number | Preis \(für Trades\) |
|   ↳ `asset` | string | Asset-/Token-ID |
|   ↳ `side` | string | Trade-Seite \(BUY/SELL\) |
|   ↳ `outcomeIndex` | number | Outcome-Index |
|   ↳ `title` | string | Markttitel |
|   ↳ `slug` | string | Markt-Slug |
|   ↳ `icon` | string | Markt-Icon-URL |
|   ↳ `eventSlug` | string | Event-Slug |
|   ↳ `outcome` | string | Outcome-Name |
|   ↳ `name` | string | Anzeigename des Benutzers |
|   ↳ `pseudonym` | string | Pseudonym des Benutzers |
|   ↳ `bio` | string | Bio des Benutzers |
|   ↳ `profileImage` | string | Profilbild-URL des Benutzers |
|   ↳ `profileImageOptimized` | string | Optimierte Profilbild-URL |

### `polymarket_get_leaderboard`

Trader-Leaderboard-Rankings nach Gewinn/Verlust oder Volumen abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `category` | string | Nein | Kategoriefilter: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE \(Standard: OVERALL\) |
| `timePeriod` | string | Nein | Zeitraum: DAY, WEEK, MONTH, ALL \(Standard: DAY\) |
| `orderBy` | string | Nein | Sortierung nach: PNL oder VOL \(Standard: PNL\) |
| `limit` | string | Nein | Anzahl der zurückzugebenden Ergebnisse \(z. B. „10"\). Bereich: 1-50, Standard: 25. |
| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse für Paginierung \(z. B. „25"\). Bereich: 0-1000, Standard: 0. |
| `user` | string | Nein | Nach bestimmter Wallet-Adresse des Benutzers filtern |
| `userName` | string | Nein | Nach Benutzername filtern |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `leaderboard` | array | Array von Leaderboard-Einträgen |
|   ↳ `rank` | string | Leaderboard-Rangposition |
|   ↳ `proxyWallet` | string | Proxy-Wallet-Adresse des Benutzers |
|   ↳ `userName` | string | Anzeigename des Benutzers |
|   ↳ `vol` | number | Handelsvolumen |
|   ↳ `pnl` | number | Gewinn und Verlust |
|   ↳ `profileImage` | string | Profilbild-URL des Benutzers |
|   ↳ `xUsername` | string | Twitter/X-Benutzername |
|   ↳ `verifiedBadge` | boolean | Ob der Benutzer ein verifiziertes Abzeichen hat |

### `polymarket_get_holders`

Top-Inhaber eines bestimmten Markt-Tokens abrufen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `market` | string | Ja | Kommagetrennte Liste von Condition-IDs \(z. B. "0x1234...abcd" oder "0x1234...abcd,0x5678...efgh"\). |
| `limit` | string | Nein | Anzahl der zurückzugebenden Inhaber \(z. B. "10"\). Bereich: 0-20, Standard: 20. |
| `minBalance` | string | Nein | Minimaler Kontostand-Schwellenwert \(Standard: 1\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `holders` | array | Array von Markt-Inhaber-Gruppen nach Token |
|   ↳ `token` | string | Token-/Asset-ID |
|   ↳ `holders` | array | Array von Inhabern für diesen Token |
|     ↳ `proxyWallet` | string | Wallet-Adresse des Inhabers |
|     ↳ `bio` | string | Bio des Inhabers |
|     ↳ `asset` | string | Asset-ID |
|     ↳ `pseudonym` | string | Pseudonym des Inhabers |
|     ↳ `amount` | number | Gehaltener Betrag |
|     ↳ `displayUsernamePublic` | boolean | Ob der Benutzername öffentlich angezeigt wird |
|     ↳ `outcomeIndex` | number | Outcome-Index |
|     ↳ `name` | string | Anzeigename des Inhabers |
|     ↳ `profileImage` | string | Profilbild-URL |
|     ↳ `profileImageOptimized` | string | Optimierte Profilbild-URL |