Effectuer votre premier appel API

Environ 5 minutes

Prérequis

• Un compte sur la console Stochio et une clé API : consultez Obtenir votre clé API.
• Python 3.9 ou version ultérieure, ou Node.js 18 ou version ultérieure.
• Un fichier candles.csv d’au moins 32 lignes, au format suivant :

date,open,high,low,close,volume
2026-09-01,101.20,102.40,100.85,102.10,18250
2026-09-02,102.05,102.90,101.30,101.75,16930
...

Étape 1 : Définir votre clé API

Exportez votre clé API en tant que variable d’environnement. Les exemples ci-dessous la lisent depuis STOCHIO_API_KEY.

export STOCHIO_API_KEY="sk-sto-..."

Étape 2 : Installer les dépendances

L’API s’appelle en HTTP. En Python, installez requests et pandas. En JavaScript, Node.js 18 et versions ultérieures incluent fetch : aucune installation n’est nécessaire.

pip install requests pandas

Étape 3 : Créer votre code

Créez un fichier nommé forecast.py (ou forecast.mjs) dans le même dossier que candles.csv :

import os

import pandas as pd
import requests

API_URL = "https://api.stochio.fr"
API_KEY = os.environ["STOCHIO_API_KEY"]

# One candle per row: date,open,high,low,close,volume (at least 32 rows)
bars = pd.read_csv("candles.csv", index_col="date", parse_dates=True)

response = requests.post(
    f"{API_URL}/v1/forecast",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "stochio-small-1",
        "timestamps": [t.isoformat() for t in bars.index],
        **{c: bars[c].tolist() for c in ["open", "high", "low", "close", "volume"]},
        "horizon": 24,
    },
    timeout=60,
)
if not response.ok:
    raise SystemExit(f"{response.status_code}: {response.json()['message']}")

candles = pd.DataFrame(response.json()["candles"]).set_index("timestamp")
print(candles)

Avec cURL, le corps de la requête se trouve dans un fichier JSON, request.json. Son format est décrit dans Create a forecast.

Étape 4 : Exécuter votre code

python forecast.py

Stochio renvoie 24 bougies, une par barre prévue :

                           open        high         low       close     volume
timestamp
2026-08-01T00:00:00  470.358560  475.846868  461.864046  466.677252   9.304603
2026-08-02T00:00:00  466.465881  477.631190  465.417798  474.497431   8.416166
2026-08-03T00:00:00  472.028782  482.052854  468.870277  476.138558   8.167905
...

Résolution des problèmes

Étapes suivantes

• Tracer un intervalle de prévisionDemandez la distribution complète et tracez l’intervalle de 10 % à 90 %.10 min
• Create a forecastTous les paramètres de la requête et les champs de la réponse.Référence de l’API