API za developere

Pošaljite svoj fom_live_… ključ kao Bearer token: /api/v1/meta potvrđuje njegovu ispravnost, /api/v1/screener vraća rangirani screener kao JSON, uz zaglavlja sa ograničenjem broja zahteva u svakom odgovoru.

Formion Data API omogućava programski pristup istim signalima koje vidite u aplikaciji — rangiranom screeneru, kalibrisanim verovatnoćama dobitnog trejda i drugim podacima — preko jednostavnog REST endpointa sa autentifikacijom. Namenjen je kvantitativnim analitičarima, autorima botova i trejding timovima koji žele Formion prednost u svojim sistemima.

Status: dostupno na zahtev. Ključeve ručno izdaje Formion tim. Samostalno kreiranje ličnih API tokena je u planu — kartica za API pristup u odeljku Profil → Licenca prikazuje Uskoro. Obratite se na [email protected] da zatražite ključ.

Autentifikacija

Svaki zahtev sadrži vaš API ključ kao bearer token:

curl "https://app.formion.ai/api/v1/screener?tf=1d&limit=25" \
  -H "Authorization: Bearer fom_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Ključevi izgledaju ovako: fom_live_…. Čuvajte ih kao lozinku — svako ko ima ključ može da poziva API u vaše ime.
Ključ se prikazuje samo jednom, prilikom izdavanja, a kod nas se čuva samo kao heš. Ako ga izgubite, opozivamo ga i izdajemo novi — ne možemo da ga povratimo.
Ključ možete proslediti i kao ?api_key=… za brzo testiranje, ali se preporučuje zaglavlje Authorization.

Ako ključ nedostaje, nije ispravan ili je opozvan, dobijate:

{ "ok": false, "error": "unauthorized", "hint": "Send a valid key as 'Authorization: Bearer fom_live_…'. Request access at [email protected]." }

uz HTTP 401.

Ograničenja broja zahteva

Svaki ključ ima dozvoljeni broj zahteva po minutu koji određuje njegov API paket (dodeljuje se prilikom izdavanja ključa):

Paket	Zahtevi / minut
Besplatni	60
Pro	600
Institutional	6 000

Svaki odgovor sadrži standardna zaglavlja kako biste sami mogli da prilagodite učestalost zahteva:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 594
X-RateLimit-Reset: 1789200000     # unix seconds when the window resets

Prekoračenje dozvoljenog broja zahteva vraća HTTP 429 uz { "ok": false, "error": "rate_limited", "tier": "…" } i zaglavlje Retry-After (u sekundama). Sačekajte pa pokušajte ponovo.

Verzionisanje

Svi endpointi su pod /api/v1/. Strukturu odgovora v1 tretiramo kao stabilan ugovor — nova polja mogu biti dodata, ali postojeća neće promeniti značenje niti nestati bez nove verzije (/api/v2/). Možete se pouzdano osloniti na v1.

Endpointi

GET /api/v1/meta`

Potvrđuje da vaš ključ radi i navodi čemu može da pristupi.

curl https://app.formion.ai/api/v1/meta -H "Authorization: Bearer fom_live_…"

{
  "ok": true,
  "api_version": "v1",
  "key": { "tier": "pro", "rate_per_min": 600, "label": "Acme backtest bot" },
  "endpoints": [
    { "path": "/api/v1/meta", "method": "GET", "desc": "This key's tier + endpoint list." },
    { "path": "/api/v1/screener", "method": "GET", "desc": "Ranked multi-market screener with Formion score + P(win). Query: tf, limit, minScore." }
  ],
  "docs": "https://docs.formion.ai/api",
  "support": "[email protected]"
}

GET /api/v1/screener`

Rangirani screener za više tržišta — isti sistem koji pokreće karticu Screener u aplikaciji.

Parametri upita

Parametar	Podrazumevano	Opis
`tf`	`1d`	Vremenski okvir: `5m`, `15m`, `1h`, `4h`, `1d`
`limit`	`100`	Broj redova koji se vraćaju (maks. 500)
`minScore`	`0`	Vraća samo redove sa ocenom ≥ ove vrednosti

Primer

curl "https://app.formion.ai/api/v1/screener?tf=4h&limit=5&minScore=60" \
  -H "Authorization: Bearer fom_live_…"

{
  "ok": true,
  "api_version": "v1",
  "tier": "pro",
  "timeframe": "4h",
  "scanned_at": 1789199400000,
  "count": 5,
  "data": [
    {
      "symbol": "SOLUSDT",
      "asset_class": "crypto",
      "category": "bull-pullback",
      "direction": "long",
      "score": 74,
      "win_probability": 0.58,
      "rsi_1d": 61,
      "tags": ["at-bull-fvg", "bos-up-1d", "arsi-turn-up-4h"]
    }
  ]
}

Pregled polja

Polje	Značenje
`symbol`	Par na berzi ili tiker
`asset_class`	Klasa imovine u redu (na primer `crypto`, `stock`, `index`, `commodity`)
`category`	Klasa setupa (`bull`, `bear-rally`, `sweep-confirmed`, …)
`direction`	`long`, `short` ili `null`
`score`	Zbirna Formion ocena, 0–100
`win_probability`	Kalibrisana verovatnoća modela da je signal tačan na horizontu datog vremenskog okvira, ili `null` ako model nije dostigao potreban prag tačnosti
`rsi_1d`	Dnevni RSI(14)
`tags`	Oznake strukture + momentuma (FVG, BoS/CHoCH, VWAP, obrti Adaptive-RSI, …)
`scanned_at`	Vreme osnovnog skeniranja u Unix ms (podaci mogu biti stari do nekoliko minuta)

Ova dva endpointa (/meta i /screener) trenutno čine ceo v1 API. Ako su vam potrebni drugi podaci, recite nam koji — dodatni endpointi još nisu obećani.

Odgovorno korišćenje

Keširajte i proveravajte podatke razumno. Screener ponavlja skeniranje svakih nekoliko minuta; češće provere samo troše vaš limit zahteva za iste podatke. Pročitajte scanned_at i preskočite proveru ako se nije promenio.
Jedan ključ po sistemu. Ne delite ključ između klijenata — merenje po ključu omogućava nama (i vama) da pratimo korišćenje.
Nikada ne stavljajte ključ u pregledač ili javni repozitorijum. Ako ključ procuri, pošaljite nam imejl da ga opozovemo i izdamo novi.

Dobijanje ključa

Pošaljite imejl na [email protected] sa opisom namene i očekivanim obimom zahteva. Izdaćemo ključ, dodeliti mu nivo i pomoći vam da prvi poziv proradi.