Documentation e-sotop Market API

# Action spécifique
GET /api/v1/markets/brvm/SNTS

# Toutes les actions cotées
GET /api/v1/markets/brvm/ALL

GET /api/v1/markets/brvm/ALL/bonds

GET /api/v1/markets/brvm/ALL/indices

# Crypto spécifique
GET /api/v1/markets/crypto/BTC
GET /api/v1/markets/crypto/ETH

# Top 500 complet
GET /api/v1/markets/crypto/ALL

# Dollar → Franc CFA
GET /api/v1/markets/forex/USDXOF

# Euro → Dirham marocain
GET /api/v1/markets/forex/EURMAD

# Toutes les devises (base USD)
GET /api/v1/markets/forex/ALL

# Actions américaines
GET /api/v1/markets/stocks/AAPL
GET /api/v1/markets/stocks/TSLA

# ADR africain
GET /api/v1/markets/stocks/MTN

# Top 300 actifs du moment
GET /api/v1/markets/stocks/ALL

# Or
GET /api/v1/markets/commodities/GOLD

# Cacao (pertinent CI, Ghana)
GET /api/v1/markets/commodities/COCOA

# Toutes les matières premières
GET /api/v1/markets/commodities/ALL

# Un fonds précis (par identifiant produit)
GET /api/v1/markets/opcvm/45

# Tous les fonds OPCVM
GET /api/v1/markets/opcvm

# Devis pour une souscription OPCVM de 100 000 XOF
POST /api/v1/quotes
Content-Type: application/json

{
  "asset_type": "opcvm",
  "asset_ref": "45",
  "side": "BUY",
  "amount": 100000
}

POST /api/v1/accounts
X-API-Key: es_live_votre_cle
Content-Type: application/json

{
  "asset_type": "opcvm",
  "profile": {
    "first_name": "Landry",
    "last_name": "Fofana",
    "email": "landry@example.com",
    "phone": "0757534697",
    "phone_code": "+225",
    "title": "M",
    "gender": "M",
    "birth_date": "1990-01-01",
    "birth_place": "Abidjan",
    "nationality": "Ivoirienne",
    "residence_country": "Côte d'ivoire",
    "city": "Abidjan",
    "address": "Marcory Rue 22",
    "profession": "Ingénieur",
    "kyc": {
      "marital_status": "Célibataire",
      "funds_origin": "Salaire",
      "politically_exposed": "Non",
      "us_resident": "Non",
      "investment_horizon": "Long terme",
      "main_objective": "Épargne"
    },
    "documents": [
      { "type": "CNI RECTO", "extension": "jpg", "number": "C-123", "content_base64": "..." },
      { "type": "CNI VERSO", "extension": "jpg", "number": "C-123", "content_base64": "..." }
    ]
  }
}

{
  "status": "success",
  "account": {
    "account_ref": "1691",
    "status": "PENDING"
  }
}

# Le partenaire a déjà encaissé : il fournit les détails de paiement
POST /api/v1/orders
X-API-Key: es_live_votre_cle
Idempotency-Key: cmd-2026-0042
Content-Type: application/json

{
  "asset_type": "opcvm",
  "asset_ref": "45",
  "side": "BUY",
  "amount": 100000,
  "end_user_ref": "1188",
  "payment": {
    "moyenPaiement": "mtn",
    "montantAPayer": 101500,
    "telephone": "0757534697",
    "reference": "cmd-2026-0042"
  }
}

{
  "status": "success",
  "order": {
    "id": "ord_a1b2c3d4e5",
    "asset_type": "opcvm",
    "side": "BUY",
    "amount": 100000,
    "state": "SUBMITTED",
    "provider": "opcvm",
    "provider_ref": "SUB-99871"
  }
}

# État d'un ordre (rafraîchi depuis le courtier)
GET /api/v1/orders/ord_a1b2c3d4e5

# Annuler (si le courtier et l'état le permettent)
POST /api/v1/orders/ord_a1b2c3d4e5/cancel

# Rechercher un compte
GET /api/v1/accounts/1188?asset_type=opcvm

# Historique des ordres du client
GET /api/v1/accounts/1188/history?asset_type=opcvm

# Portefeuille détaillé (positions, valorisation, plus-value)
GET /api/v1/accounts/1188/portfolio?asset_type=opcvm

# Portefeuille global (performance + courbe d'évolution)
GET /api/v1/accounts/1188/summary?asset_type=opcvm