Skip to main content
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 :
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 :
Les échecs de validation (par exemple, des paramètres de requête incorrects) renvoient un tableau :

​
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

​
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.