Docs

APIPraćenje

Alarmi

Pravila po vozilu: pad ili rast vrijednosti, ciljne cijene, LTV i povoljni oglasi.

Svako praćeno vozilo ima svoja pravila (alerts). Provjeravaju se nakon jutarnje procjene; alarm se čuva, stiže webhookom watchlist.alert, ulazi u dnevni izvještaj i na listu GET /v1/alerts.

alerts

  • change_pctnumber | nullopcionalno3 – 90

    Alarm kad se vrijednost pomjeri za ovoliko posto: od početne vrijednosti, zatim od vrijednosti pri zadnjem alarmu. Najmanje 3, jer samo ponovno treniranje modela pomjeri vrijednosti ~2%. null isključuje.

  • directionenumopcionalno

    Koji pomak broji za change_pct: any (podrazumijevano), up ili down.

    anyupdown
  • below_baminteger | nullopcionalno100 – 5.000.000

    Alarm kad vrijednost padne ispod ove cijene (KM).

  • above_baminteger | nullopcionalno100 – 5.000.000

    Alarm kad vrijednost poraste iznad ove cijene (KM).

  • exposure_pctnumber | nullopcionalno10 – 300

    Vlastita vozila: alarm na dan kad izloženost (dug, osigurana suma, trošak) dostigne ovaj postotak vrijednosti (LTV), samo pri rastu.

  • deal_pctnumber | nullopcionalno5 – 50

    Tražena vozila: alarm za svaki novi oglas iste specifikacije koji traži ovoliko posto manje od Cifrine cijene (najviše 5 dnevno).

Kako pravila rade

PraviloKad javlja
change_pctVrijednost se pomjerila za toliko posto od polazne, a nakon prvog alarma od vrijednosti pri zadnjem alarmu. Spori pad se tako javi kad se nakupi, a jedan pomak ne javlja svaki dan. direction ograničava na pad ili rast.
below_bam / above_bamVrijednost je prešla ciljnu cijenu (ne svaki dan dok je preko nje).
exposure_pctLTV je dostigao prag, pri rastu.
deal_pctTraženo vozilo: novi oglas istog modela, godište ±1, kilometraža ±30% (najmanje ±30.000 km), isto gorivo i mjenjač, traži toliko posto ispod Cifrine cijene. Najviše 5 dnevno, najbolji prvi; oglasi ispod 55% vrijednosti se preskaču (to je obično oštećenje, ne prilika).
Dva modela trenirana na skoro istim podacima razlikuju se oko 2% po vozilu. Zato change_pct ne ide ispod 3%, a alarm nosi details.modelChanged kad je tog dana počeo raditi novi model — dio pomaka je tada model, ne tržište.

Alarm

market_deal
{
  "object": "alert",
  "id": "alr_Vb3nQ7xR2kLp9TzW5mYc",
  "type": "market_deal",
  "watched_vehicle": {
    "id": "wv_9QeL2mXc7TbN4vR8kPz1",
    "label": "Traži: Octavia 2018+",
    "external_ref": null,
    "kind": "wanted"
  },
  "day": "2026-10-20",
  "previous_value": 24900,
  "value": 21500,
  "change_pct": -13.65,
  "threshold": 12,
  "details": {
    "listing": {
      "id": 9812334,
      "title": "Škoda Octavia 2.0 TDI Style",
      "year": 2018,
      "km": 168000,
      "price": 21500,
      "fairPrice": 24900,
      "place": "Mostar",
      "url": "https://olx.ba/artikal/61234567",
      "seller": "PRIVATE"
    }
  },
  "created_at": "2026-10-20T06:09:31.000Z"
}

Ne propustite alarm

Webhook je najbrži put, a lista je rezerva: ako je vaš sistem bio nedostupan, pročitajte GET /v1/alerts?since=… od zadnjeg obrađenog trenutka. Alarm ima stabilan id, pa isti alarm iz webhooka i liste obradite jednom.