helebest/holo-polymarket

Requête Polymarket

Compétence en lecture seule pour consulter les marchés de prédiction Polymarket (elle ne passe jamais d'ordres). Elle répond à deux besoins :

• Recherche de marchés : événements chauds, recherche, détails d'un événement, historique des prix et tendances de probabilité/volume.
• Suivi des positions et des baleines : classement des traders, positions et P&L d'une adresse, historique des transactions.

Pour acheter/vendre (passer des ordres, annuler, consulter les soldes, gérer les ordres), utilisez la compétence polymarket-trade.

Démarrage rapide

1. Vérifiez l'environnement : bash, curl, jq, et l'accès à gamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.com.
2. Choisissez un type de tâche : informations sur le marché / baleines et positions / tendances historiques.
3. Exécutez la commande correspondante : bash <skill-dir>/scripts/polymarket.sh <commande> [arguments...].

Liste complète des commandes : references/commands.md. Dépannage : references/troubleshooting.md.

Choix d'une commande

• Marchés chauds : hot [limite].
• Rechercher des marchés par mot-clé : search <mot-clé> [limite].
• Inspecter un événement par slug (avec ses jetons) : detail <slug-événement>.
• Suivre les meilleurs traders / vérifier les positions : leaderboard (alias lb) → positions (alias pos) → trades.
  • Positions ouvertes uniquement : positions <adresse> [limite] --active.
  • Votre propre wallet : avec POLYMARKET_FUNDER (ou FUNDER) défini, positions / trades l'utiliseront par défaut si aucune adresse n'est fournie. Utilisez l'adresse de votre portefeuille proxy (celui qui détient les fonds/positions), pas le signataire/EOA.
• Analyse séries temporelles :
  • Tableau des probabilités : history
  • Résumé des variations début/fin : trend
  • Variations de volume : volume-trend
• Export de fichier : ajoutez --format csv|json et optionnellement --out <fichier> à history/trend/volume-trend.

Exemples minimaux

# 1) Marchés chauds
bash <skill-dir>/scripts/polymarket.sh hot 5

# 2) Recherche + détails
bash <skill-dir>/scripts/polymarket.sh search bitcoin 5
bash <skill-dir>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) Suivi des baleines et positions
bash <skill-dir>/scripts/polymarket.sh lb 10 pnl week
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # ouvertes uniquement
bash <skill-dir>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) Tendances historiques + export
bash <skill-dir>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <skill-dir>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <skill-dir>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

Règles des paramètres : from/to sont au format YYYY-MM-DD ; interval est 1h / 4h / 1d.

Échecs courants

• Dépendances manquantes : installez curl / jq.
• Problèmes réseau : vérifiez l'accessibilité des API et les délais d'attente ; augmentez CURL_TIMEOUT si nécessaire. Dans un environnement proxy, HTTPS_PROXY est détecté automatiquement.
• Échecs des prix historiques : vérifiez POLYMARKET_BEARER_TOKEN ou un fichier de credentials (voir ci-dessous).
• Erreurs d'arguments : revérifiez l'usage de la commande et le format de la date (YYYY-MM-DD).

Credentials (seul l'endpoint des prix historiques en nécessite un)

L'endpoint des prix historiques peut nécessiter un jeton Bearer. Il est résolu dans cet ordre (neutre vis-à-vis de l'agent, non lié à un runtime particulier) :

1. Variable d'environnement POLYMARKET_BEARER_TOKEN
2. Le fichier nommé par POLYMARKET_CREDENTIALS_FILE
3. ./.credentials dans le répertoire du projet (doit être dans .gitignore)
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials (fallback hérité)

Le fichier de credentials est au format CLÉ=VALEUR et prend en charge les champs BEARER_TOKEN / TOKEN.

Le même fichier (ou la variable d'environnement) peut également fournir POLYMARKET_FUNDER / FUNDER — votre adresse de portefeuille proxy. Lorsqu'elle est définie, positions / trades l'utiliseront par défaut si aucune adresse n'est fournie en ligne de commande. C'est la seule identité que cette compétence de requête lit ; tout le reste ici est en lecture seule et public.

Limite de trading

Cette compétence est en lecture seule et ne passe jamais d'ordres. Pour acheter/vendre, annuler, consulter les soldes et gérer les ordres, utilisez la compétence polymarket-trade (construite sur l'API CLOB officielle).