> ## Documentation Index
> Fetch the complete documentation index at: https://docs.counsel.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence de l'API counsel v1 : marchés parimutuels sur XRPL

> Référence complète de l'API counsel v1. En lecture seule, sans authentification, toutes les réponses en JSON. Sept points de terminaison : marchés, construction de paris, comptes et classement.

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 :

```json theme={null}
{ "error": "market not found" }
```

Les échecs de validation (par exemple, des paramètres de requête incorrects) renvoient un tableau :

```json theme={null}
{ "errors": ["invalid account address", "amount must be positive"] }
```

| Statut HTTP | Signification                                           |
| ----------- | ------------------------------------------------------- |
| `400`       | Requête incorrecte, paramètres invalides                |
| `403`       | Interdit, adresse sur la liste de blocage de conformité |
| `404`       | Ressource introuvable                                   |
| `500`       | Erreur 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éthode | Chemin                         | Description                                                        |
| ------- | ------------------------------ | ------------------------------------------------------------------ |
| `GET`   | `/markets`                     | Tous 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-intent`      | Payment XRPL non signé + cotes projetées après mise                |
| `GET`   | `/accounts/:address/positions` | Les mises d'un compte par marché et par issue                      |
| `GET`   | `/accounts/:address/feed`      | Les paris récents d'un leader (alimente le copy trading)           |
| `GET`   | `/accounts/:address/profile`   | Statistiques, série de volume cumulé, positions, rang              |
| `GET`   | `/leaderboard`                 | Volume 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.

<CardGroup cols={2}>
  <Card title="Lister les marchés" icon="list" href="/api/markets/list">
    Récupérez tous les marchés publics avec les totaux de pool en direct et les cotes indicatives.
  </Card>

  <Card title="Obtenir un marché" icon="chart-bar" href="/api/markets/get">
    Récupérez un marché unique par son ID, plafonds de pari inclus.
  </Card>

  <Card title="Intention de pari" icon="pen" href="/api/markets/bet-intent">
    Construisez un Payment XRPL non signé, prêt à être signé et soumis.
  </Card>

  <Card title="Vue d'ensemble" icon="book" href="/api/overview">
    Codes d'erreur, limites de débit et référence de l'URL de base.
  </Card>
</CardGroup>