Fanta-Trade-API
Verbinde dein Programm oder deinen Bot mit deinem virtuellen Portfolio: kaufen und verkaufen, Orders und Stop-Loss erteilen, Portfolio und Bewegungen abrufen. Gleiche Spielregeln, kein echtes Geld.
1. Schlüssel erstellen
Melde dich an und gehe zu Profil › API: Benenne den Schlüssel und kopiere ihn sofort, denn er wird nur einmal angezeigt. Du kannst bis zu 3 haben und sie jederzeit widerrufen.
2. Authentifizierung
Sende den Schlüssel bei jeder Anfrage im Authorization-Header (oder X-API-Key). Antworten sind JSON: Daten in «data», Fehler in «error» mit Code und Meldung.
curl -H "Authorization: Bearer ft_la_tua_chiave" https://www.fanta-trade.eu/api/v1/accountBasis-URL: https://www.fanta-trade.eu/api/v1 · Beträge und Kurse in Euro, Datumsangaben im ISO-8601-Format
3. Endpunkte
GET /api/v1/account
Dein Konto: Liquidität, investierter Wert, Gesamtwert, Rendite seit Beginn, Anzahl der Positionen und offenen Orders.
Beispielantwort
{"data":{"id":42,"name":"Marco Rossi","currency":"EUR","cash":22226.49,"invested":77870.2,"total":100096.69,"performance_pct":0.1,"positions":8,"open_orders":2,"starting_capital":100000.0}}GET /api/v1/portfolio
Offene Positionen mit Menge, durchschnittlichem Einstandskurs, letztem Kurs, Wert, Gewinn oder Verlust und Portfoliogewicht.
Beispielantwort
{"data":{"currency":"EUR","cash":22226.49,"total":100096.69,"positions":[{"symbol":"ENI.MI","name":"Eni","quantity":400.0,"avg_price":15.12,"price":15.48,"currency":"EUR","value":6192.0,"pl":144.0,"pl_pct":2.38,"weight_pct":6.19}]}}GET /api/v1/transactions?limit=50&offset=0
Deine Bewegungen, die neuesten zuerst (höchstens 100 pro Anfrage).
Beispielantwort
{"data":{"total":37,"limit":50,"offset":0,"items":[{"id":901,"date":"2026-10-14T10:02:11+02:00","symbol":"ENI.MI","name":"Eni","side":"buy","quantity":100.0,"price":15.48,"currency":"EUR","amount":1548.0,"realized_pl":null,"cash_after":22226.49}]}}POST /api/v1/trades
Kaufen oder verkaufen zum aktuellen Kurs. Felder: symbol (Yahoo-Format, z. B. ENI.MI, AAPL), side (buy oder sell), quantity.
curl -X POST -H "Authorization: Bearer ft_la_tua_chiave" -H "Content-Type: application/json" \
-d '{"symbol":"ENI.MI","side":"buy","quantity":100}' https://www.fanta-trade.eu/api/v1/tradesBeispielantwort
{"data":{"message":"…","transaction":{"id":902,"symbol":"ENI.MI","side":"buy","quantity":100.0,"price":15.48,"amount":1548.0}}}GET /api/v1/orders
Offene Orders. type ist buy_limit (kaufen, wenn er fällt), buy_stop (kaufen, wenn er steigt), stop_loss (verkaufen, wenn er fällt) oder take_profit (verkaufen, wenn er steigt).
Beispielantwort
{"data":[{"id":55,"symbol":"ENI.MI","side":"sell","type":"stop_loss","quantity":100.0,"price":14.5,"currency":"EUR","status":"open","created_at":"…","expires_at":"…"}]}POST /api/v1/orders
Erteilt eine «Kaufen zu / Verkaufen zu»-Order: Sie wird ausgeführt, wenn der Kurs price (in Euro) erreicht. Ein Verkauf unter dem aktuellen Kurs ist ein Stop-Loss, darüber eine Gewinnmitnahme. expiry: 1w, 1m (Standard) oder 3m.
curl -X POST -H "Authorization: Bearer ft_la_tua_chiave" -H "Content-Type: application/json" \
-d '{"symbol":"ENI.MI","side":"sell","quantity":100,"price":14.50,"expiry":"1m"}' https://www.fanta-trade.eu/api/v1/ordersBeispielantwort
{"data":{"id":56,"symbol":"ENI.MI","side":"sell","type":"stop_loss","quantity":100.0,"price":14.5,"status":"open"}}DELETE /api/v1/orders/{id}
Storniert eine offene Order.
curl -X DELETE -H "Authorization: Bearer ft_la_tua_chiave" https://www.fanta-trade.eu/api/v1/orders/56Beispielantwort
{"data":{"id":56,"status":"cancelled"}}4. Fehler
| HTTP | Code | Wann |
|---|---|---|
| 400 | invalid_symbol · invalid_side · invalid_quantity · invalid_price | Fehlende oder ungültige Felder. |
| 401 | unauthorized | Fehlender, falscher oder widerrufener Schlüssel. |
| 404 | not_found | Unbekannter Endpunkt oder Order nicht gefunden bzw. bereits geschlossen. |
| 422 | trade_rejected · order_rejected | Die Operation verstößt gegen die Spielregeln (Liquidität, Limits, Kurs nicht verfügbar): Die Meldung erklärt den Grund. |
| 429 | rate_limited · trade_limit · symbol_limit | Eines der unten genannten Limits wurde überschritten. Der Retry-After-Header gibt an, wie viele Sekunden zu warten sind. |
5. Limits und faire Nutzung
- 30 Anfragen pro Minute und 1.000 pro Tag je Schlüssel (die X-RateLimit-*-Header zeigen, wie viele übrig sind).
- 50 Trades und Orders pro Tag, abgelehnte eingeschlossen.
- Höchstens 10 verschiedene Wertpapiere pro Tag, die du noch nicht besitzt, für Käufe, Verkäufe oder Orders; mit Wertpapieren in deinem Besitz kannst du frei handeln.
- Es gelten alle Spielregeln: verfügbare Liquidität, maximales Gewicht eines Wertpapiers im Portfolio, Tagesvolumenlimit und höchstens 50 offene Orders.
- Die API gewährt nur Zugriff auf dein eigenes Konto. Sie liefert keine Kurse, Suchen oder Historien: Kurse erscheinen nur für Wertpapiere in deinem Besitz und sind die zuletzt von Fanta-Trade gespeicherten, die verzögert sein können.
- Es ist verboten, die API zum Sammeln oder Weiterverbreiten von Marktdaten zu nutzen: Bei Missbrauch werden die Schlüssel widerrufen und das Konto kann gesperrt werden.