La passerelle courtiers

Le principe

• ELEGG Finance vous déclare comme courtier partenaire et vous remet une clé « elegg_partner_… ». Elle désigne votre société, pas un client.
• Votre client vous autorise dans ELEGG FX (Paramètres → Courtiers) : il obtient un code de liaison à usage unique, valable sept jours, qu'il vous transmet.
• Vous présentez ce code avec votre propre référence du client (« customer_ref ») : le lien est établi. Ensuite, vous désignez toujours ce client par cette référence.
• Vous envoyez les opérations exécutées pour ce client. Vous ne pouvez relire que celles-ci : ni ses besoins, ni son exposition, ni ses opérations avec d'autres banques.
• Le client peut retirer son autorisation à tout moment : vos envois suivants pour lui sont refusés (403 not_linked).

Les points d'accès

Adresse de base : https://eleggfinance.com/api/partner/v1. En-tête Authorization: Bearer elegg_partner_… sur chaque appel. 120 appels par minute et par clé.

curl -X POST https://eleggfinance.com/api/partner/v1/links \
  -H "Authorization: Bearer elegg_partner_…" \
  -H "Content-Type: application/json" \
  -d '{ "code": "LIEN-7K2Q-9XMD-4TRA", "customer_ref": "CLI-00042" }'

Envoyer les opérations

Chaque opération a les champs d'une couverture de l'API client : reference (votre numéro d'opération), product_type (forward, forward_open, ndf, vanilla, tunnel, leveraged, ki_forward), currency, side (buy : le client achète la devise ; sell : il la vend), notional, maturity_date, et selon le produit rate, trade_date, option_kind, strike_short, barrier_type, barrier_level…

Renvoyer la même référence met l'opération à jour : vous faites foi sur vos opérations. Envoi tout ou rien, 1000 opérations au plus. Dates au format AAAA-MM-JJ, cours en devise pour 1 euro.

curl -X PUT https://eleggfinance.com/api/partner/v1/trades \
  -H "Authorization: Bearer elegg_partner_…" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_ref": "CLI-00042",
    "trades": [
      {
        "reference": "DEAL-2026-118204",
        "product_type": "forward",
        "currency": "USD",
        "side": "buy",
        "notional": 250000,
        "rate": 1.0912,
        "maturity_date": "2027-01-29",
        "trade_date": "2026-10-19"
      }
    ]
  }'

{
  "imported": 1,
  "pending": 0,
  "updated": 0,
  "results": [
    { "reference": "DEAL-2026-118204", "status": "imported", "hedge_id": "3c1e…", "change": "created" }
  ]
}

Ce que devient une opération

• imported : elle est enregistrée comme couverture dans le compte du client.
• pending : elle ressemble à une couverture que le client avait déjà saisie (même devise et sens, échéance à trois jours près, montant à 1 % près). Il décide lui-même : la fusionner, l'ajouter ou l'écarter. Rien n'est compté deux fois sans qu'il l'ait vu.
• merged : le client l'a fusionnée avec sa saisie ; la couverture prend les valeurs de votre confirmation.
• dismissed : le client l'a écartée. Vos mises à jour sont conservées, sa décision aussi.
• cancelled : vous l'avez annulée. Une couverture que vous aviez créée est retirée ; une couverture saisie par le client puis fusionnée lui reste.

Erreurs

Même format que l'API client : { "error": { "code", "message", "details" } }.

• 401 missing_key / invalid_key : clé absente, inconnue, révoquée ou courtier suspendu.
• 403 not_linked : aucun client relié sous cette référence, ou autorisation retirée.
• 404 invalid_code / 410 invalid_code : code de liaison inconnu, déjà utilisé ou expiré.
• 409 conflict : cette référence client est déjà reliée à un compte.
• 422 validation_failed : au moins une opération refusée ; « details » les liste toutes, rien n'est écrit.
• 429 rate_limited : trop d'appels, réessayez dans un instant.