Skip to content

Démarrage rapide

Importez votre premier trade en 5 minutes.

1. Créer une clé API

  1. Connectez-vous à votre compte InsighTrades
  2. Allez dans API Keys (/api-keys)
  3. Cliquez sur "Créer une clé"
  4. Donnez un nom à votre clé (ex: "Production Server")
  5. Copiez immédiatement la clé - elle ne sera plus affichée !

Attention

La clé complète n'est affichée qu'une seule fois. Stockez-la en lieu sûr (gestionnaire de mots de passe, variable d'environnement, etc.).

2. Préparer vos données

Vos trades doivent être au format suivant :

json
{
  "trades": [
    {
      "brokerTradeId": "12345",     // ID unique du trade chez votre broker
      "symbol": "EURUSD",            // Symbole tradé
      "action": "BUY",               // BUY ou SELL
      "openPrice": 1.1234,           // Prix d'entrée
      "closePrice": 1.1256,          // Prix de sortie
      "lotSize": 0.1,                // Taille de la position
      "openTime": "2024-01-15T10:00:00Z",  // Date/heure d'ouverture (ISO 8601)
      "closeTime": "2024-01-15T12:00:00Z", // Date/heure de fermeture (ISO 8601)
      "profit": 22.0,                // Profit/perte
      "commission": 2.5,             // (Optionnel) Commission
      "swap": -0.5,                  // (Optionnel) Frais de swap
      "comment": "Trade manuel"      // (Optionnel) Commentaire
    }
  ]
}

3. Envoyer votre première requête

JavaScript (Node.js / Browser)

javascript
const apiKey = 'ik_live_votre_clé_ici';

const response = await fetch('https://api.insightrades.com/trades/import', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    trades: [{
      brokerTradeId: '12345',
      symbol: 'EURUSD',
      action: 'BUY',
      openPrice: 1.1234,
      closePrice: 1.1256,
      lotSize: 0.1,
      openTime: '2024-01-15T10:00:00Z',
      closeTime: '2024-01-15T12:00:00Z',
      profit: 22.0
    }]
  })
});

const result = await response.json();
console.log(`${result.imported} trades importés avec succès!`);

Python

python
import requests

api_key = 'ik_live_votre_clé_ici'

response = requests.post(
    'https://api.insightrades.com/trades/import',
    headers={
        'X-API-Key': api_key,
        'Content-Type': 'application/json'
    },
    json={
        'trades': [{
            'brokerTradeId': '12345',
            'symbol': 'EURUSD',
            'action': 'BUY',
            'openPrice': 1.1234,
            'closePrice': 1.1256,
            'lotSize': 0.1,
            'openTime': '2024-01-15T10:00:00Z',
            'closeTime': '2024-01-15T12:00:00Z',
            'profit': 22.0
        }]
    }
)

result = response.json()
print(f"{result['imported']} trades importés avec succès!")

PHP

php
<?php

$apiKey = 'ik_live_votre_clé_ici';

$ch = curl_init('https://api.insightrades.com/trades/import');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'trades' => [[
        'brokerTradeId' => '12345',
        'symbol' => 'EURUSD',
        'action' => 'BUY',
        'openPrice' => 1.1234,
        'closePrice' => 1.1256,
        'lotSize' => 0.1,
        'openTime' => '2024-01-15T10:00:00Z',
        'closeTime' => '2024-01-15T12:00:00Z',
        'profit' => 22.0
    ]]
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo "{$result['imported']} trades importés avec succès!";

4. Vérifier le résultat

La réponse sera au format :

json
{
  "imported": 1,
  "failed": 0
}
  • imported : nombre de trades importés avec succès
  • failed : nombre de trades échoués

Connectez-vous à votre compte InsighTrades et vérifiez que vos trades apparaissent dans la section Trades.

Étapes suivantes

Besoin d'aide ?

Si vous rencontrez des problèmes :

  1. Vérifiez que votre clé API est correcte
  2. Assurez-vous que le format des données est respecté
  3. Consultez la référence API pour plus de détails
  4. Contactez le support : support@insightrades.com

Documentation de l'API InsighTrades