TraderAI
Analyse de graphique IAGraphique en directTableau de bordTous les outils
Tarifs
PRO
API développeurs
Passer à Pro
Se connecterCréer un compte
TraderAI/API développeurs/Documentation Developer API

Documentation Developer API

Trouvez un endpoint, protégez vos clés et intégrez des limites de crédits claires.

Ouvrir la consoleComparer les offresOpenAPI 3.1

Protégez vos identifiants

Créez une clé dans la console et envoyez-la depuis votre serveur avec Authorization: Bearer ou X-API-Key. Ne placez jamais de clé dans une URL, du code public de navigateur, des statistiques ou un dépôt. Le secret apparaît une seule fois ; révoquez toute clé compromise.

Réessayez avec la même identité

Enregistrez Idempotency-Key avant exécution et réutilisez-la si la réponse est perdue. Une entrée différente avec la même identité est refusée. La relecture vérifie les droits actuels sans nouveau débit. Une identité conservée dont le résultat a expiré ne permet pas une nouvelle exécution. Un résultat incertain exige un rapprochement.

Estimez et plafonnez les dépenses

Demandez une estimation, puis exécutez avec X-Max-Credits. Elle expire ; le prix et les droits sont revérifiés à l’exécution. Projets et clés partagent le forfait de crédits et le portefeuille du compte. Créer un projet ne donne aucun crédit. Dans un lot partiel, les succès restent facturés ; réessayez les échecs avec leur identité initiale.

Interprétez les données manquantes

Les bougies utilisent les secondes Unix UTC. Une valeur nulle indique une initialisation incomplète ou une donnée indisponible, pas zéro. Un volume manquant diffère d’un zéro observé. Similarité et qualité du scénario ne sont pas des probabilités de gain. asOf historique est indisponible sans preuve à la date demandée.

Une politique pour sept transports

REST, GraphQL, JSON-RPC, MCP, lots ordonnés, résultats SSE et Socket.IO partagent authentification et comptage. Examinez chaque erreur, même avec HTTP 200. SSE et Socket.IO renvoient des tâches, pas des cours en direct. GraphQL conserve JSON et ajoute des requêtes typées.

TypeScript et Python

Les SDK conservent l’identité lors des tentatives limitées, respectent Retry-After et permettent délais et annulation. Ne répétez pas aveuglément les erreurs de saisie, d’authentification, de droits ou de solde. Utilisez des variables d’environnement côté serveur. Les exemples calculent une taille de position.

cURL
curl -X POST https://traderai.cloud/api/v1/open/risk/position-size \
  -H "Authorization: Bearer $TRADERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountBalance":10000,"riskPercent":1,"entryPrice":100,"stopLossPrice":95,"takeProfitPrice":110}'
Python
import os, requests

res = requests.post(
    "https://traderai.cloud/api/v1/open/risk/position-size",
    headers={"Authorization": f"Bearer {os.environ['TRADERAI_API_KEY']}"},
    json={"accountBalance": 10000, "riskPercent": 1, "entryPrice": 100, "stopLossPrice": 95},
    timeout=30,
)
print(res.json()["meta"]["creditsCharged"])

Équipes et droits sur les données

Les équipes partagent les crédits prépayés du titulaire de facturation. Ajouter des membres, projets ou clés n’augmente pas le quota.

Seul le titulaire de facturation peut acheter des crédits ou consulter ses paiements. Les membres voient la consommation de l’équipe.

L’accès dépend des droits approuvés de la source, de la région et de l’usage. Une offre supérieure n’accorde pas la redistribution. Les flux en direct ne sont pas encore disponibles.

Tâches et webhooks

Lancez une tâche avec votre clé API. Recevez les événements de fin sur votre endpoint HTTPS. Une nouvelle livraison ne relance pas la tâche.

Les événements sont évalués quand votre application envoie des bougies clôturées. Aucun suivi en direct sans nouvelles données.

POST /open/jobs
{ "endpoint": "risk.position-size", "input": { "accountBalance": 10000, "riskPercent": 1, "entryPrice": 100, "stopLossPrice": 95 }, "options": { "idempotencyKey": "my-job-1", "maxCredits": 10 } }

GET /open/jobs/{id}
GET /open/jobs/{id}/result
POST /open/jobs/{id}/cancel

POST /open/workflows
POST /open/workflows/{id}/run

POST /open/subscriptions
POST /open/subscriptions/{id}/push
GET /open/subscriptions/{id}/events?after=0&limit=20

Référence des endpoints

POST /open/indicators/computeCrédits par unité de travail: 1 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One OHLCV bar. time = bar OPEN time in UTC seconds (or milliseconds; auto-detected). Ascending, unique.",
        "properties": {
          "time": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "number",
            "description": "Optional. Required by volume studies."
          }
        },
        "required": [
          "time",
          "open",
          "high",
          "low",
          "close"
        ]
      },
      "minItems": 2,
      "maxItems": 5000
    },
    "indicators": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Indicator id from GET /indicators."
          },
          "params": {
            "type": "object",
            "additionalProperties": true
          },
          "key": {
            "type": "string",
            "maxLength": 40,
            "description": "Optional label echoed back."
          }
        },
        "required": [
          "id"
        ]
      }
    },
    "last": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000,
      "description": "Return only the newest N points of each series."
    }
  },
  "required": [
    "candles",
    "indicators"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "integer",
      "minimum": 2
    },
    "indicators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "family": {
            "type": "string"
          },
          "formulaVersion": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Validated effective indicator parameters."
          },
          "outputs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "points": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "number",
                        "description": "Bar OPEN time in UTC Unix seconds."
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Indicator-native units. null means warm-up, a gap, or mathematically unavailable; never zero-fill."
                      }
                    },
                    "required": [
                      "time",
                      "value"
                    ],
                    "additionalProperties": true
                  }
                }
              },
              "required": [
                "id",
                "points"
              ],
              "additionalProperties": true
            }
          },
          "key": {
            "type": "string",
            "description": "Optional caller label."
          }
        },
        "required": [
          "id",
          "family",
          "formulaVersion",
          "params",
          "outputs"
        ],
        "additionalProperties": true
      }
    },
    "metadata": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string"
        },
        "origin": {
          "type": "string",
          "enum": [
            "caller",
            "server"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "computedAt": {
          "type": "string",
          "description": "UTC ISO 8601 timestamp."
        },
        "dataAsOf": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "lastClosedBar": {
          "type": [
            "number",
            "null"
          ],
          "description": "Bar OPEN time in UTC Unix seconds."
        },
        "barPolicy": {
          "type": "string",
          "enum": [
            "closed",
            "caller-supplied"
          ]
        },
        "market": {
          "type": [
            "string",
            "null"
          ]
        },
        "requestedSymbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolvedInstrument": {
          "type": "null"
        },
        "venue": {
          "type": "null"
        },
        "currency": {
          "type": "null"
        },
        "units": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "enum": [
                "unix_seconds"
              ]
            },
            "prices": {
              "type": "string"
            },
            "volume": {
              "type": "string"
            }
          },
          "required": [
            "time",
            "prices",
            "volume"
          ],
          "additionalProperties": true
        },
        "volume": {
          "type": "object",
          "properties": {
            "missingBars": {
              "type": "number"
            },
            "zeroBars": {
              "type": "number"
            }
          },
          "required": [
            "missingBars",
            "zeroBars"
          ],
          "additionalProperties": true
        },
        "gaps": {
          "type": "object",
          "properties": {
            "assessed": {
              "type": "boolean"
            },
            "missingIntervals": {
              "type": [
                "number",
                "null"
              ]
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "after": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "before": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "missing": {
                    "type": "number"
                  }
                },
                "required": [
                  "after",
                  "before",
                  "missing"
                ],
                "additionalProperties": true
              }
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "assessed",
            "missingIntervals",
            "ranges",
            "truncated"
          ],
          "additionalProperties": true
        },
        "stale": {
          "type": "null"
        },
        "delaySeconds": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "version",
        "origin",
        "observedAt",
        "computedAt",
        "dataAsOf",
        "lastClosedBar",
        "barPolicy",
        "market",
        "requestedSymbol",
        "resolvedInstrument",
        "venue",
        "currency",
        "units",
        "volume",
        "gaps",
        "stale",
        "delaySeconds"
      ],
      "additionalProperties": true,
      "description": "Unknown instrument, venue, currency and stale status remain null until the adapter supplies verified evidence. observedAt is API observation time, not a provider publication timestamp."
    }
  },
  "required": [
    "candles",
    "indicators"
  ],
  "additionalProperties": true
}
POST /open/patterns/detectCrédits par unité de travail: 2 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One OHLCV bar. time = bar OPEN time in UTC seconds (or milliseconds; auto-detected). Ascending, unique.",
        "properties": {
          "time": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "number",
            "description": "Optional. Required by volume studies."
          }
        },
        "required": [
          "time",
          "open",
          "high",
          "low",
          "close"
        ]
      },
      "minItems": 2,
      "maxItems": 5000
    },
    "max": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "candles"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "patterns": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "descriptionKey": {
            "type": "string"
          },
          "bias": {
            "type": "string",
            "enum": [
              "bullish",
              "bearish",
              "neutral"
            ]
          },
          "strength": {
            "type": "string",
            "enum": [
              "strong",
              "moderate",
              "weak"
            ]
          },
          "candleIndex": {
            "type": "integer",
            "minimum": 0
          },
          "time": {
            "type": "number",
            "description": "Bar OPEN time in UTC Unix seconds."
          },
          "price": {
            "type": "number",
            "description": "Chart annotation price, not an executable quote."
          }
        },
        "required": [
          "id",
          "label",
          "description",
          "descriptionKey",
          "bias",
          "strength",
          "candleIndex",
          "time",
          "price"
        ],
        "additionalProperties": true
      },
      "description": "Empty array means no detected pattern, not a request failure."
    },
    "note": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string"
        },
        "origin": {
          "type": "string",
          "enum": [
            "caller",
            "server"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "computedAt": {
          "type": "string",
          "description": "UTC ISO 8601 timestamp."
        },
        "dataAsOf": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "lastClosedBar": {
          "type": [
            "number",
            "null"
          ],
          "description": "Bar OPEN time in UTC Unix seconds."
        },
        "barPolicy": {
          "type": "string",
          "enum": [
            "closed",
            "caller-supplied"
          ]
        },
        "market": {
          "type": [
            "string",
            "null"
          ]
        },
        "requestedSymbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolvedInstrument": {
          "type": "null"
        },
        "venue": {
          "type": "null"
        },
        "currency": {
          "type": "null"
        },
        "units": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "enum": [
                "unix_seconds"
              ]
            },
            "prices": {
              "type": "string"
            },
            "volume": {
              "type": "string"
            }
          },
          "required": [
            "time",
            "prices",
            "volume"
          ],
          "additionalProperties": true
        },
        "volume": {
          "type": "object",
          "properties": {
            "missingBars": {
              "type": "number"
            },
            "zeroBars": {
              "type": "number"
            }
          },
          "required": [
            "missingBars",
            "zeroBars"
          ],
          "additionalProperties": true
        },
        "gaps": {
          "type": "object",
          "properties": {
            "assessed": {
              "type": "boolean"
            },
            "missingIntervals": {
              "type": [
                "number",
                "null"
              ]
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "after": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "before": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "missing": {
                    "type": "number"
                  }
                },
                "required": [
                  "after",
                  "before",
                  "missing"
                ],
                "additionalProperties": true
              }
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "assessed",
            "missingIntervals",
            "ranges",
            "truncated"
          ],
          "additionalProperties": true
        },
        "stale": {
          "type": "null"
        },
        "delaySeconds": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "version",
        "origin",
        "observedAt",
        "computedAt",
        "dataAsOf",
        "lastClosedBar",
        "barPolicy",
        "market",
        "requestedSymbol",
        "resolvedInstrument",
        "venue",
        "currency",
        "units",
        "volume",
        "gaps",
        "stale",
        "delaySeconds"
      ],
      "additionalProperties": true,
      "description": "Unknown instrument, venue, currency and stale status remain null until the adapter supplies verified evidence. observedAt is API observation time, not a provider publication timestamp."
    }
  },
  "required": [
    "patterns",
    "note"
  ],
  "additionalProperties": true
}
POST /open/risk/position-sizeCrédits par unité de travail: 1 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {
    "accountBalance": {
      "type": "number",
      "minimum": 0
    },
    "riskPercent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "entryPrice": {
      "type": "number"
    },
    "stopLossPrice": {
      "type": "number"
    },
    "takeProfitPrice": {
      "type": "number"
    },
    "leverage": {
      "type": "number",
      "minimum": 1,
      "maximum": 200,
      "default": 1
    }
  },
  "required": [
    "accountBalance",
    "riskPercent",
    "entryPrice",
    "stopLossPrice"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    },
    "riskAmount": {
      "type": "number"
    },
    "quantity": {
      "type": "number"
    },
    "notional": {
      "type": "number"
    },
    "marginRequired": {
      "type": "number"
    },
    "stopDistance": {
      "type": "number"
    },
    "stopDistancePercent": {
      "type": [
        "number",
        "null"
      ],
      "description": "Percent of entry price."
    },
    "rewardRisk": {
      "type": [
        "number",
        "null"
      ],
      "description": "Dimensionless reward/risk ratio; null without a target."
    },
    "potentialProfit": {
      "type": [
        "number",
        "null"
      ],
      "description": "Account/quote currency; excludes fees, slippage and contract multipliers."
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "direction",
    "riskAmount",
    "quantity",
    "notional",
    "marginRequired",
    "stopDistance",
    "stopDistancePercent",
    "rewardRisk",
    "potentialProfit",
    "note"
  ],
  "additionalProperties": true,
  "description": "Quantity is base asset units. Monetary numbers are calculated IEEE-754 estimates, not venue fills or payment amounts."
}
POST /open/volatility/forecastCrédits par unité de travail: 2 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One OHLCV bar. time = bar OPEN time in UTC seconds (or milliseconds; auto-detected). Ascending, unique.",
        "properties": {
          "time": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "number",
            "description": "Optional. Required by volume studies."
          }
        },
        "required": [
          "time",
          "open",
          "high",
          "low",
          "close"
        ]
      },
      "minItems": 2,
      "maxItems": 5000
    }
  },
  "required": [
    "candles"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "lastClose": {
      "type": "number"
    },
    "sigmaPercent": {
      "type": "number",
      "description": "Expected next-bar move in percent; not direction."
    },
    "range68": {
      "type": "object",
      "properties": {
        "lower": {
          "type": "number"
        },
        "upper": {
          "type": "number"
        }
      },
      "required": [
        "lower",
        "upper"
      ],
      "additionalProperties": true
    },
    "range95": {
      "type": "object",
      "properties": {
        "lower": {
          "type": "number"
        },
        "upper": {
          "type": "number"
        }
      },
      "required": [
        "lower",
        "upper"
      ],
      "additionalProperties": true
    },
    "note": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string"
        },
        "origin": {
          "type": "string",
          "enum": [
            "caller",
            "server"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "computedAt": {
          "type": "string",
          "description": "UTC ISO 8601 timestamp."
        },
        "dataAsOf": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "lastClosedBar": {
          "type": [
            "number",
            "null"
          ],
          "description": "Bar OPEN time in UTC Unix seconds."
        },
        "barPolicy": {
          "type": "string",
          "enum": [
            "closed",
            "caller-supplied"
          ]
        },
        "market": {
          "type": [
            "string",
            "null"
          ]
        },
        "requestedSymbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolvedInstrument": {
          "type": "null"
        },
        "venue": {
          "type": "null"
        },
        "currency": {
          "type": "null"
        },
        "units": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "enum": [
                "unix_seconds"
              ]
            },
            "prices": {
              "type": "string"
            },
            "volume": {
              "type": "string"
            }
          },
          "required": [
            "time",
            "prices",
            "volume"
          ],
          "additionalProperties": true
        },
        "volume": {
          "type": "object",
          "properties": {
            "missingBars": {
              "type": "number"
            },
            "zeroBars": {
              "type": "number"
            }
          },
          "required": [
            "missingBars",
            "zeroBars"
          ],
          "additionalProperties": true
        },
        "gaps": {
          "type": "object",
          "properties": {
            "assessed": {
              "type": "boolean"
            },
            "missingIntervals": {
              "type": [
                "number",
                "null"
              ]
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "after": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "before": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "missing": {
                    "type": "number"
                  }
                },
                "required": [
                  "after",
                  "before",
                  "missing"
                ],
                "additionalProperties": true
              }
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "assessed",
            "missingIntervals",
            "ranges",
            "truncated"
          ],
          "additionalProperties": true
        },
        "stale": {
          "type": "null"
        },
        "delaySeconds": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "version",
        "origin",
        "observedAt",
        "computedAt",
        "dataAsOf",
        "lastClosedBar",
        "barPolicy",
        "market",
        "requestedSymbol",
        "resolvedInstrument",
        "venue",
        "currency",
        "units",
        "volume",
        "gaps",
        "stale",
        "delaySeconds"
      ],
      "additionalProperties": true,
      "description": "Unknown instrument, venue, currency and stale status remain null until the adapter supplies verified evidence. observedAt is API observation time, not a provider publication timestamp."
    }
  },
  "required": [
    "model",
    "lastClose",
    "sigmaPercent",
    "range68",
    "range95",
    "note"
  ],
  "additionalProperties": true
}
POST /open/analogs/searchCrédits par unité de travail: 10 · Offre minimale: starter

Schéma des entrées

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One OHLCV bar. time = bar OPEN time in UTC seconds (or milliseconds; auto-detected). Ascending, unique.",
        "properties": {
          "time": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "number",
            "description": "Optional. Required by volume studies."
          }
        },
        "required": [
          "time",
          "open",
          "high",
          "low",
          "close"
        ]
      },
      "minItems": 2,
      "maxItems": 20000
    },
    "intervalSec": {
      "type": "number",
      "minimum": 60,
      "maximum": 604800
    },
    "window": {
      "type": "number",
      "enum": [
        20,
        30,
        50,
        100
      ],
      "default": 30
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "default": 10
    }
  },
  "required": [
    "candles",
    "intervalSec"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "methodVersion": {
      "type": "string"
    },
    "intervalSec": {
      "type": "number"
    },
    "window": {
      "type": "number"
    },
    "horizons": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "query": {
      "type": "object",
      "properties": {
        "startTime": {
          "type": "number"
        },
        "endTime": {
          "type": "number"
        },
        "close": {
          "type": "number"
        },
        "features": {
          "type": "object",
          "properties": {
            "rsi": {
              "type": "number"
            },
            "atrPct": {
              "type": "number"
            },
            "rangePos": {
              "type": "number"
            },
            "rsiZone": {
              "type": "string",
              "enum": [
                "oversold",
                "neutral",
                "overbought"
              ]
            },
            "trendAtr": {
              "type": [
                "number",
                "null"
              ]
            },
            "trend": {
              "type": [
                "string",
                "null"
              ]
            },
            "fundingRate": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "rsi",
            "atrPct",
            "rangePos",
            "rsiZone",
            "trendAtr",
            "trend",
            "fundingRate"
          ],
          "additionalProperties": true
        },
        "path": {
          "type": "array",
          "items": {
            "type": "number"
          }
        }
      },
      "required": [
        "startTime",
        "endTime",
        "close",
        "features",
        "path"
      ],
      "additionalProperties": true
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number"
          },
          "startTime": {
            "type": "number"
          },
          "endTime": {
            "type": "number"
          },
          "similarity": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "features": {
            "type": "object",
            "properties": {
              "rsi": {
                "type": "number"
              },
              "atrPct": {
                "type": "number"
              },
              "rangePos": {
                "type": "number"
              },
              "rsiZone": {
                "type": "string",
                "enum": [
                  "oversold",
                  "neutral",
                  "overbought"
                ]
              },
              "trendAtr": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "trend": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "fundingRate": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "rsi",
              "atrPct",
              "rangePos",
              "rsiZone",
              "trendAtr",
              "trend",
              "fundingRate"
            ],
            "additionalProperties": true
          },
          "outcomes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "horizon": {
                  "type": "number"
                },
                "returnPct": {
                  "type": "number"
                },
                "maePct": {
                  "type": "number"
                },
                "mfePct": {
                  "type": "number"
                }
              },
              "required": [
                "horizon",
                "returnPct",
                "maePct",
                "mfePct"
              ],
              "additionalProperties": true
            }
          },
          "path": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "forward": {
            "type": "array",
            "items": {
              "type": "number"
            }
          }
        },
        "required": [
          "rank",
          "startTime",
          "endTime",
          "similarity",
          "close",
          "features",
          "outcomes",
          "path",
          "forward"
        ],
        "additionalProperties": true
      }
    },
    "stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "horizon": {
            "type": "number"
          },
          "sample": {
            "type": "number"
          },
          "medianPct": {
            "type": "number"
          },
          "p25Pct": {
            "type": "number"
          },
          "p75Pct": {
            "type": "number"
          },
          "meanPct": {
            "type": "number"
          },
          "upPct": {
            "type": "number"
          },
          "worstReturnPct": {
            "type": "number"
          },
          "bestReturnPct": {
            "type": "number"
          },
          "worstDrawdownPct": {
            "type": "number"
          },
          "bestRunupPct": {
            "type": "number"
          }
        },
        "required": [
          "horizon",
          "sample",
          "medianPct",
          "p25Pct",
          "p75Pct",
          "meanPct",
          "upPct",
          "worstReturnPct",
          "bestReturnPct",
          "worstDrawdownPct",
          "bestRunupPct"
        ],
        "additionalProperties": true
      }
    },
    "coverage": {
      "type": "object",
      "properties": {
        "bars": {
          "type": "number"
        },
        "firstTime": {
          "type": "number"
        },
        "lastTime": {
          "type": "number"
        },
        "candidates": {
          "type": "number"
        },
        "eligible": {
          "type": "number"
        }
      },
      "required": [
        "bars",
        "firstTime",
        "lastTime",
        "candidates",
        "eligible"
      ],
      "additionalProperties": true
    },
    "fundingUsed": {
      "type": "boolean"
    },
    "fundingCoverage": {
      "type": "number"
    },
    "unavailable": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "insufficient_history",
        "flat_window",
        "no_candidates",
        null
      ]
    },
    "note": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string"
        },
        "origin": {
          "type": "string",
          "enum": [
            "caller",
            "server"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "computedAt": {
          "type": "string",
          "description": "UTC ISO 8601 timestamp."
        },
        "dataAsOf": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "lastClosedBar": {
          "type": [
            "number",
            "null"
          ],
          "description": "Bar OPEN time in UTC Unix seconds."
        },
        "barPolicy": {
          "type": "string",
          "enum": [
            "closed",
            "caller-supplied"
          ]
        },
        "market": {
          "type": [
            "string",
            "null"
          ]
        },
        "requestedSymbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolvedInstrument": {
          "type": "null"
        },
        "venue": {
          "type": "null"
        },
        "currency": {
          "type": "null"
        },
        "units": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "enum": [
                "unix_seconds"
              ]
            },
            "prices": {
              "type": "string"
            },
            "volume": {
              "type": "string"
            }
          },
          "required": [
            "time",
            "prices",
            "volume"
          ],
          "additionalProperties": true
        },
        "volume": {
          "type": "object",
          "properties": {
            "missingBars": {
              "type": "number"
            },
            "zeroBars": {
              "type": "number"
            }
          },
          "required": [
            "missingBars",
            "zeroBars"
          ],
          "additionalProperties": true
        },
        "gaps": {
          "type": "object",
          "properties": {
            "assessed": {
              "type": "boolean"
            },
            "missingIntervals": {
              "type": [
                "number",
                "null"
              ]
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "after": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "before": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "missing": {
                    "type": "number"
                  }
                },
                "required": [
                  "after",
                  "before",
                  "missing"
                ],
                "additionalProperties": true
              }
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "assessed",
            "missingIntervals",
            "ranges",
            "truncated"
          ],
          "additionalProperties": true
        },
        "stale": {
          "type": "null"
        },
        "delaySeconds": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "version",
        "origin",
        "observedAt",
        "computedAt",
        "dataAsOf",
        "lastClosedBar",
        "barPolicy",
        "market",
        "requestedSymbol",
        "resolvedInstrument",
        "venue",
        "currency",
        "units",
        "volume",
        "gaps",
        "stale",
        "delaySeconds"
      ],
      "additionalProperties": true,
      "description": "Unknown instrument, venue, currency and stale status remain null until the adapter supplies verified evidence. observedAt is API observation time, not a provider publication timestamp."
    }
  },
  "required": [
    "methodVersion",
    "intervalSec",
    "window",
    "horizons",
    "query",
    "matches",
    "stats",
    "coverage",
    "fundingUsed",
    "fundingCoverage",
    "unavailable",
    "note"
  ],
  "additionalProperties": true,
  "description": "Similarity is a distance score, not a probability. Inspect unavailable even on HTTP 200."
}
POST /open/backtest/runCrédits par unité de travail: 25 · Offre minimale: starter

Schéma des entrées

{
  "type": "object",
  "properties": {
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One OHLCV bar. time = bar OPEN time in UTC seconds (or milliseconds; auto-detected). Ascending, unique.",
        "properties": {
          "time": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "number",
            "description": "Optional. Required by volume studies."
          }
        },
        "required": [
          "time",
          "open",
          "high",
          "low",
          "close"
        ]
      },
      "minItems": 2,
      "maxItems": 20000
    },
    "strategy": {
      "type": "object",
      "description": "Same strategy object as the TraderAI backtester: initialCapital, indicators, entryConditions, exitCondition, positionSizing, tradingCost.",
      "additionalProperties": true
    }
  },
  "required": [
    "candles",
    "strategy"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "result": {
      "type": "object",
      "properties": {
        "metrics": {
          "type": "object",
          "properties": {
            "totalTrades": {
              "type": "number"
            },
            "winningTrades": {
              "type": "number"
            },
            "losingTrades": {
              "type": "number"
            },
            "winRate": {
              "type": "number"
            },
            "totalPnlPct": {
              "type": "number"
            },
            "totalPnlAbs": {
              "type": "number"
            },
            "profitFactor": {
              "type": "number"
            },
            "maxDrawdownPct": {
              "type": "number"
            },
            "sharpeRatio": {
              "type": "number"
            },
            "sortino": {
              "type": "number"
            },
            "avgWinPct": {
              "type": "number"
            },
            "avgLossPct": {
              "type": "number"
            },
            "avgRR": {
              "type": "number"
            },
            "expectancy": {
              "type": "number"
            },
            "initialCapital": {
              "type": "number"
            },
            "finalCapital": {
              "type": "number"
            },
            "equity": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "time": {
                    "type": "string",
                    "description": "UTC ISO 8601 timestamp."
                  },
                  "equity": {
                    "type": "number"
                  }
                },
                "required": [
                  "time",
                  "equity"
                ],
                "additionalProperties": true
              }
            },
            "monthlyPnl": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "month": {
                    "type": "string"
                  },
                  "pnl": {
                    "type": "number"
                  }
                },
                "required": [
                  "month",
                  "pnl"
                ],
                "additionalProperties": true
              }
            },
            "costs": {
              "type": "object",
              "properties": {
                "commission": {
                  "type": "number"
                },
                "slippage": {
                  "type": "number"
                },
                "funding": {
                  "type": "number"
                },
                "total": {
                  "type": "number"
                },
                "totalPctOfCapital": {
                  "type": "number"
                },
                "grossPnlAbs": {
                  "type": "number"
                }
              },
              "required": [
                "commission",
                "slippage",
                "funding",
                "total",
                "totalPctOfCapital",
                "grossPnlAbs"
              ],
              "additionalProperties": true
            },
            "costConfig": {
              "type": "object",
              "properties": {
                "commissionPct": {
                  "type": "number"
                },
                "slippagePct": {
                  "type": "number"
                },
                "fundingRatePct": {
                  "type": "number"
                },
                "fundingIntervalHours": {
                  "type": "number"
                }
              },
              "required": [
                "commissionPct",
                "slippagePct",
                "fundingRatePct",
                "fundingIntervalHours"
              ],
              "additionalProperties": true
            },
            "skippedEntries": {
              "type": "number"
            },
            "coverage": {
              "type": "object",
              "properties": {
                "continuousClosedBars": {
                  "type": "boolean"
                },
                "barsAnalyzed": {
                  "type": "number"
                },
                "barsRequested": {
                  "type": "number"
                },
                "truncated": {
                  "type": "boolean"
                },
                "actualDateFrom": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "UTC ISO 8601 timestamp."
                },
                "actualDateTo": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "UTC ISO 8601 timestamp."
                }
              },
              "required": [
                "barsAnalyzed",
                "barsRequested",
                "truncated",
                "actualDateFrom",
                "actualDateTo"
              ],
              "additionalProperties": true
            }
          },
          "required": [
            "totalTrades",
            "winningTrades",
            "losingTrades",
            "winRate",
            "totalPnlPct",
            "totalPnlAbs",
            "profitFactor",
            "maxDrawdownPct",
            "sharpeRatio",
            "sortino",
            "avgWinPct",
            "avgLossPct",
            "avgRR",
            "expectancy",
            "initialCapital",
            "finalCapital",
            "equity",
            "monthlyPnl"
          ],
          "additionalProperties": true,
          "description": "Calculated engine metrics in account currency/percent. Profit factor 999 is the existing no-loss sentinel, not an observed finite return. Optional cost/coverage blocks absent means unavailable, not zero."
        },
        "trades": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "entryTime": {
                "type": "string",
                "description": "UTC ISO 8601 timestamp."
              },
              "exitTime": {
                "type": "string",
                "description": "UTC ISO 8601 timestamp."
              },
              "direction": {
                "type": "string",
                "enum": [
                  "long",
                  "short"
                ]
              },
              "entryPrice": {
                "type": "number"
              },
              "exitPrice": {
                "type": "number"
              },
              "pnlPct": {
                "type": "number"
              },
              "pnlAbs": {
                "type": "number"
              },
              "rr": {
                "type": "number"
              },
              "grossPnlAbs": {
                "type": "number"
              },
              "exitReason": {
                "type": "string",
                "enum": [
                  "tp",
                  "sl",
                  "trailing",
                  "max_bars",
                  "eod",
                  "rule"
                ]
              },
              "costs": {
                "type": "object",
                "additionalProperties": true,
                "description": "Commission, slippage and funding breakdown in account currency."
              }
            },
            "required": [
              "entryTime",
              "exitTime",
              "direction",
              "entryPrice",
              "exitPrice",
              "pnlPct",
              "pnlAbs",
              "rr",
              "exitReason"
            ],
            "additionalProperties": true
          }
        },
        "ruleEvidence": {
          "type": "object",
          "additionalProperties": true,
          "description": "Versioned condition-tree evidence, present only when a rule was evaluated. This extension remains JSON for compatibility."
        }
      },
      "required": [
        "metrics",
        "trades"
      ],
      "additionalProperties": true
    },
    "bars": {
      "type": "integer"
    },
    "costModel": {
      "type": "object",
      "properties": {
        "commissionPct": {
          "type": "number"
        },
        "slippagePct": {
          "type": "number"
        },
        "fundingRatePct": {
          "type": "number"
        },
        "fundingIntervalHours": {
          "type": "number"
        }
      },
      "required": [
        "commissionPct",
        "slippagePct",
        "fundingRatePct",
        "fundingIntervalHours"
      ],
      "additionalProperties": true
    },
    "metadata": {
      "type": "object",
      "properties": {
        "version": {
          "type": "string"
        },
        "origin": {
          "type": "string",
          "enum": [
            "caller",
            "server"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "computedAt": {
          "type": "string",
          "description": "UTC ISO 8601 timestamp."
        },
        "dataAsOf": {
          "type": [
            "string",
            "null"
          ],
          "description": "UTC ISO 8601 timestamp."
        },
        "lastClosedBar": {
          "type": [
            "number",
            "null"
          ],
          "description": "Bar OPEN time in UTC Unix seconds."
        },
        "barPolicy": {
          "type": "string",
          "enum": [
            "closed",
            "caller-supplied"
          ]
        },
        "market": {
          "type": [
            "string",
            "null"
          ]
        },
        "requestedSymbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolvedInstrument": {
          "type": "null"
        },
        "venue": {
          "type": "null"
        },
        "currency": {
          "type": "null"
        },
        "units": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "enum": [
                "unix_seconds"
              ]
            },
            "prices": {
              "type": "string"
            },
            "volume": {
              "type": "string"
            }
          },
          "required": [
            "time",
            "prices",
            "volume"
          ],
          "additionalProperties": true
        },
        "volume": {
          "type": "object",
          "properties": {
            "missingBars": {
              "type": "number"
            },
            "zeroBars": {
              "type": "number"
            }
          },
          "required": [
            "missingBars",
            "zeroBars"
          ],
          "additionalProperties": true
        },
        "gaps": {
          "type": "object",
          "properties": {
            "assessed": {
              "type": "boolean"
            },
            "missingIntervals": {
              "type": [
                "number",
                "null"
              ]
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "after": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "before": {
                    "type": "number",
                    "description": "Bar OPEN time in UTC Unix seconds."
                  },
                  "missing": {
                    "type": "number"
                  }
                },
                "required": [
                  "after",
                  "before",
                  "missing"
                ],
                "additionalProperties": true
              }
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "assessed",
            "missingIntervals",
            "ranges",
            "truncated"
          ],
          "additionalProperties": true
        },
        "stale": {
          "type": "null"
        },
        "delaySeconds": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "version",
        "origin",
        "observedAt",
        "computedAt",
        "dataAsOf",
        "lastClosedBar",
        "barPolicy",
        "market",
        "requestedSymbol",
        "resolvedInstrument",
        "venue",
        "currency",
        "units",
        "volume",
        "gaps",
        "stale",
        "delaySeconds"
      ],
      "additionalProperties": true,
      "description": "Unknown instrument, venue, currency and stale status remain null until the adapter supplies verified evidence. observedAt is API observation time, not a provider publication timestamp."
    }
  },
  "required": [
    "result",
    "bars",
    "costModel"
  ],
  "additionalProperties": true
}
POST /open/ai/chart-analysisCrédits par unité de travail: 500 · Offre minimale: builder

Schéma des entrées

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Base64 PNG/JPEG/WebP (data URL or raw base64), max 4 MB."
    },
    "market": {
      "type": "string",
      "enum": [
        "crypto",
        "forex",
        "stocks"
      ],
      "default": "crypto"
    },
    "timeframe": {
      "type": "string",
      "maxLength": 8
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "default": "en"
    }
  },
  "required": [
    "image"
  ]
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "analysis": {
      "type": "object",
      "properties": {
        "patterns": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "trend": {
          "type": "string"
        },
        "summary": {
          "type": "string"
        },
        "critique": {
          "type": "string"
        },
        "confidence": {
          "type": "string"
        },
        "marketBias": {
          "type": "string"
        },
        "recommendation": {
          "type": "string"
        },
        "reasoning": {
          "type": "string"
        },
        "ticker": {
          "type": "string"
        },
        "volumeAnalysis": {
          "type": "string"
        },
        "macroContext": {
          "type": "string"
        },
        "cautionNote": {
          "type": "string"
        },
        "direction": {
          "type": "string",
          "enum": [
            "long",
            "short",
            "none"
          ]
        },
        "entry": {
          "type": "number"
        },
        "stopLoss": {
          "type": "number"
        },
        "takeProfit": {
          "type": "number"
        },
        "riskReward": {
          "type": "number"
        },
        "keyLevels": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tradePlan": {
          "type": "object",
          "properties": {
            "entryCondition": {
              "type": "string"
            },
            "slReason": {
              "type": "string"
            },
            "tp1Note": {
              "type": "string"
            },
            "tp1Size": {
              "type": "string"
            },
            "tp2Note": {
              "type": "string"
            },
            "tp2Size": {
              "type": "string"
            },
            "breakeven": {
              "type": "string"
            },
            "invalidation": {
              "type": "string"
            },
            "takeProfit1": {
              "type": "number"
            },
            "takeProfit2": {
              "type": "number"
            }
          },
          "required": [
            "entryCondition",
            "slReason",
            "tp1Note",
            "tp1Size",
            "tp2Note",
            "tp2Size",
            "breakeven",
            "invalidation",
            "takeProfit1",
            "takeProfit2"
          ],
          "additionalProperties": true
        },
        "pricePlan": {
          "type": "object",
          "additionalProperties": true,
          "description": "Canonical validated price plan, when available; legacy scalar prices remain aliases."
        },
        "setupScore": {
          "type": "object",
          "additionalProperties": true,
          "description": "Technical quality grade. Not a probability of profit."
        },
        "leverageAnalysis": {
          "type": "object",
          "properties": {
            "leverageVerdict": {
              "type": "string"
            },
            "suggestedLeverage": {
              "type": "string"
            },
            "liquidationRisk": {
              "type": "string"
            },
            "costNote": {
              "type": "string"
            },
            "advice": {
              "type": "string"
            }
          },
          "required": [
            "leverageVerdict",
            "suggestedLeverage",
            "liquidationRisk",
            "costNote",
            "advice"
          ],
          "additionalProperties": true
        },
        "advisories": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Deterministic advisory code and supporting numeric evidence."
          }
        },
        "textEncodingIssue": {
          "type": "boolean"
        }
      },
      "required": [
        "patterns",
        "trend",
        "direction",
        "entry",
        "stopLoss",
        "takeProfit",
        "riskReward",
        "summary",
        "critique",
        "confidence"
      ],
      "additionalProperties": true
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "analysis",
    "note"
  ],
  "additionalProperties": true,
  "description": "AI analysis may have direction=none or a cautionNote; neither constitutes an execution recommendation."
}
GET /open/track-record/patternsCrédits par unité de travail: 1 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {}
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "patterns": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "market": {
            "type": "string"
          },
          "patternId": {
            "type": "string"
          },
          "bias": {
            "type": "string"
          },
          "firstDate": {
            "type": "string"
          },
          "lastDate": {
            "type": "string"
          },
          "total": {
            "type": "number"
          },
          "wins": {
            "type": "number"
          },
          "winRatePct": {
            "type": "number"
          },
          "avgEdgePct": {
            "type": "number"
          },
          "baselinePct": {
            "type": "number"
          },
          "edgeVsBaselinePct": {
            "type": "number"
          }
        },
        "required": [
          "market",
          "patternId",
          "bias",
          "firstDate",
          "lastDate",
          "total",
          "wins",
          "winRatePct",
          "avgEdgePct",
          "baselinePct",
          "edgeVsBaselinePct"
        ],
        "additionalProperties": true
      },
      "description": "Empty until recorded observations exist. Percent fields use 0..100."
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "version",
        "computedAt",
        "source",
        "status",
        "modelVersion",
        "promptVersion",
        "cohorts",
        "limitations"
      ],
      "properties": {
        "version": {
          "type": "string"
        },
        "computedAt": {
          "type": "string"
        },
        "source": {
          "type": "string",
          "enum": [
            "recorded_pattern_outcomes",
            "recorded_volatility_forecasts"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "available",
            "empty",
            "incomplete"
          ]
        },
        "modelVersion": {
          "type": "null"
        },
        "promptVersion": {
          "type": "null"
        },
        "cohorts": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "market",
              "key",
              "bias",
              "sampleSize",
              "period",
              "baseline",
              "outcomes"
            ],
            "properties": {
              "market": {
                "type": "string"
              },
              "key": {
                "type": "string"
              },
              "bias": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sampleSize": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0
              },
              "period": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "firstDate",
                  "lastDate",
                  "dateBasis"
                ],
                "properties": {
                  "firstDate": {
                    "type": "string"
                  },
                  "lastDate": {
                    "type": "string"
                  },
                  "dateBasis": {
                    "type": "string",
                    "enum": [
                      "pattern_entry_date_utc",
                      "forecast_date_utc"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "baseline": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "kind",
                  "valuePct",
                  "sampleSize",
                  "period",
                  "uncertainty"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "resolved_pattern_occurrence_pool_bias_adjusted",
                      "nominal_model_coverage"
                    ]
                  },
                  "valuePct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "sampleSize": {
                    "type": "null"
                  },
                  "period": {
                    "type": "null"
                  },
                  "uncertainty": {
                    "type": "null"
                  }
                }
              },
              "outcomes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "metric",
                    "successes",
                    "ratePct",
                    "nominalCoveragePct",
                    "uncertainty"
                  ],
                  "properties": {
                    "metric": {
                      "type": "string",
                      "enum": [
                        "directional_win",
                        "within_68_band",
                        "within_95_band"
                      ]
                    },
                    "successes": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "minimum": 0
                    },
                    "ratePct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "nominalCoveragePct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "uncertainty": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "required": [
                        "method",
                        "confidenceLevel",
                        "lowerPct",
                        "upperPct",
                        "interpretation"
                      ],
                      "properties": {
                        "method": {
                          "type": "string",
                          "enum": [
                            "wilson_score"
                          ]
                        },
                        "confidenceLevel": {
                          "type": "number"
                        },
                        "lowerPct": {
                          "type": "number"
                        },
                        "upperPct": {
                          "type": "number"
                        },
                        "interpretation": {
                          "type": "string",
                          "enum": [
                            "descriptive_binomial_interval_not_independence_adjusted"
                          ]
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                }
              }
            }
          }
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "patterns"
  ],
  "additionalProperties": true
}
GET /open/track-record/volatilityCrédits par unité de travail: 1 · Offre minimale: free

Schéma des entrées

{
  "type": "object",
  "properties": {}
}

Schéma de réponse

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "market": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "firstDate": {
            "type": "string"
          },
          "lastDate": {
            "type": "string"
          },
          "total": {
            "type": "number"
          },
          "hit68": {
            "type": "number"
          },
          "hit95": {
            "type": "number"
          },
          "hit68Pct": {
            "type": "number"
          },
          "hit95Pct": {
            "type": "number"
          },
          "avgForecastPct": {
            "type": "number"
          },
          "avgActualPct": {
            "type": "number"
          }
        },
        "required": [
          "market",
          "symbol",
          "firstDate",
          "lastDate",
          "total",
          "hit68",
          "hit95",
          "hit68Pct",
          "hit95Pct",
          "avgForecastPct",
          "avgActualPct"
        ],
        "additionalProperties": true
      },
      "description": "Recorded observations only. Empty does not imply perfect calibration."
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "version",
        "computedAt",
        "source",
        "status",
        "modelVersion",
        "promptVersion",
        "cohorts",
        "limitations"
      ],
      "properties": {
        "version": {
          "type": "string"
        },
        "computedAt": {
          "type": "string"
        },
        "source": {
          "type": "string",
          "enum": [
            "recorded_pattern_outcomes",
            "recorded_volatility_forecasts"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "available",
            "empty",
            "incomplete"
          ]
        },
        "modelVersion": {
          "type": "null"
        },
        "promptVersion": {
          "type": "null"
        },
        "cohorts": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "market",
              "key",
              "bias",
              "sampleSize",
              "period",
              "baseline",
              "outcomes"
            ],
            "properties": {
              "market": {
                "type": "string"
              },
              "key": {
                "type": "string"
              },
              "bias": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sampleSize": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0
              },
              "period": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "firstDate",
                  "lastDate",
                  "dateBasis"
                ],
                "properties": {
                  "firstDate": {
                    "type": "string"
                  },
                  "lastDate": {
                    "type": "string"
                  },
                  "dateBasis": {
                    "type": "string",
                    "enum": [
                      "pattern_entry_date_utc",
                      "forecast_date_utc"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "baseline": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "kind",
                  "valuePct",
                  "sampleSize",
                  "period",
                  "uncertainty"
                ],
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "resolved_pattern_occurrence_pool_bias_adjusted",
                      "nominal_model_coverage"
                    ]
                  },
                  "valuePct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "sampleSize": {
                    "type": "null"
                  },
                  "period": {
                    "type": "null"
                  },
                  "uncertainty": {
                    "type": "null"
                  }
                }
              },
              "outcomes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "metric",
                    "successes",
                    "ratePct",
                    "nominalCoveragePct",
                    "uncertainty"
                  ],
                  "properties": {
                    "metric": {
                      "type": "string",
                      "enum": [
                        "directional_win",
                        "within_68_band",
                        "within_95_band"
                      ]
                    },
                    "successes": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "minimum": 0
                    },
                    "ratePct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "nominalCoveragePct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "uncertainty": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "required": [
                        "method",
                        "confidenceLevel",
                        "lowerPct",
                        "upperPct",
                        "interpretation"
                      ],
                      "properties": {
                        "method": {
                          "type": "string",
                          "enum": [
                            "wilson_score"
                          ]
                        },
                        "confidenceLevel": {
                          "type": "number"
                        },
                        "lowerPct": {
                          "type": "number"
                        },
                        "upperPct": {
                          "type": "number"
                        },
                        "interpretation": {
                          "type": "string",
                          "enum": [
                            "descriptive_binomial_interval_not_independence_adjusted"
                          ]
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                }
              }
            }
          }
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "symbols"
  ],
  "additionalProperties": true
}

Compatibilité et modifications

Le schéma devapi-2026-11-14.1 ajoute les contrôles d’opération, les schémas de réponse et les requêtes GraphQL typées. Les champs v1 existants restent disponibles. Les versions des formules sont indépendantes. Vérifiez le schéma publié avant de mettre à jour un client généré.