Passer au contenu principal
L’API counsel v1 est une API HTTP publique en lecture seule pour le marché de prédiction parimutuel counsel sur le XRP Ledger. Elle expose l’état des marchés en direct, les cotes indicatives, la construction de transactions de pari non signées, les positions de compte et les données de classement. Aucune clé d’API, aucun OAuth, aucune inscription : chaque réponse est du JSON brut. L’API est consommée aussi bien par l’application web counsel que par des bots et des intégrateurs tiers.

​
URL de base

L’API est accessible via deux URL de base équivalentes : 
https://api.counsel.markets
https://counsel.markets/api/v1
Tous les chemins ci-dessous sont relatifs à l’une ou l’autre des bases. Le sous-domaine canonique (api.counsel.markets) est préférable pour les clients programmatiques ; la forme basée sur le chemin (/api/v1) est fournie par commodité.

​
Authentification

Aucune. Tous les points de terminaison sont accessibles publiquement sans identifiants. Pas d’en-tête Authorization, pas de clé d’API, pas de cookie de session.

​
Format des réponses

Toutes les réponses sont en application/json. Les réponses réussies renvoient un HTTP 200 avec un objet JSON. Les réponses de collection incluent un champ de premier niveau generated_at (horodatage ISO 8601) indiquant le moment où l’instantané de l’indexeur a été produit.

​
Format des erreurs

Les erreurs renvoient un code de statut HTTP autre que 2xx et un corps JSON. Les réponses à erreur unique utilisent : 
{ "error": "market not found" }
Les échecs de validation (par exemple, des paramètres de requête incorrects) renvoient un tableau : 
{ "errors": ["invalid account address", "amount must be positive"] }
Statut HTTPSignification
400Requête incorrecte, paramètres invalides
403Interdit, adresse sur la liste de blocage de conformité
404Ressource introuvable
500Erreur interne de l’indexeur ou du serveur

​
Limitation de débit

Aucune limite de débit stricte n’est publiée. L’API repose sur un indexeur XRPL en direct ; traitez-la comme n’importe quelle API publique partagée et évitez d’interroger à des intervalles plus courts que quelques secondes. Si vous exploitez un bot, mettez en cache la liste des marchés et ne la récupérez à nouveau qu’à un rythme raisonnable.

​
Points de terminaison

MéthodeCheminDescription
GET/marketsTous les marchés publics avec pools en direct et cotes indicatives
GET/markets/:idÉtat en direct d’un marché unique, issues et plafonds de pari
GET/markets/:id/bet-intentPayment XRPL non signé + cotes projetées après mise
GET/accounts/:address/positionsLes mises d’un compte par marché et par issue
GET/accounts/:address/feedLes paris récents d’un leader (alimente le copy trading)
GET/accounts/:address/profileStatistiques, série de volume cumulé, positions, rang
GET/leaderboardVolume attribué par SourceTag et comptes actifs

​
Champs de réponse communs

generated_at, présent sur toutes les réponses de liste. Chaîne ISO 8601 représentant le moment où l’instantané de l’indexeur a été généré. Utilisez-le pour détecter les données obsolètes ; dans des conditions normales, il devrait se situer à quelques secondes de l’heure actuelle. source_tag, présent sur /markets et /markets/:id/bet-intent. Le SourceTag que counsel utilise pour attribuer le volume on-chain. Ne le retirez pas des transactions que vous construisez ou signez.

Lister les marchés

Récupérez tous les marchés publics avec les totaux de pool en direct et les cotes indicatives.

Obtenir un marché

Récupérez un marché unique par son ID, plafonds de pari inclus.

Intention de pari

Construisez un Payment XRPL non signé, prêt à être signé et soumis.

Vue d'ensemble

Codes d’erreur, limites de débit et référence de l’URL de base.