Felo API PlatformFelo API Platform
Všechny endpointy Kalshi
v0.2.0-beta
OpenAPI 3.1.0

Získat obchody Kalshi

Server:https://openapi.felo.ai
Klientské knihovny

Kalshi

​

Prediction-market data.

Získat obchody Kalshi

​

Načte pásku uskutečněných obchodů pro trhy Kalshi — skutečné realizace, nikoli kotace. Použijte, když potřebujete realizované ceny a objem obchodů v daném okně, například abyste viděli, jak se přesvědčení vyvíjelo během události; zužte rozsah pomocí ticker a rozsahu min_ts / max_ts v unixových sekundách a nastavte is_block_trade pro izolaci velkých vyjednaných obchodů. Vrací trades[] s trade_id, ticker, count_fp (kontrakty), yes_price_dollars / no_price_dollars, taker_side a created_time plus cursor pro stránkování. Aktuální kotace, pravidla vypořádání a metadata trhu místo realizací najdete v get_kalshi_markets.

Cenová reference

  • Měření: pevná nákladová základna za úspěšný požadavek.
  • Referenční odhad požadavku: USD 0.02.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Parametry dotazu
  • cursor
    Typ: string

    Kurzor stránkování. Pro získání další stránky výsledků použijte hodnotu kurzoru vrácenou v předchozí odpovědi. Pro první stránku ponechte prázdné.

  • is_block_trade
    Typ: boolean

    Filtrujte obchody podle toho, zda jde o blokové obchody. Vynechte pro vrácení všech obchodů. Nastavte true pro vrácení pouze blokových obchodů. Nastavte false pro vrácení pouze neblokových obchodů.

  • limit
    Typ: integer Formát: int64
    min:  
    0
    max:  
    1000

    Počet výsledků na stránku. Výchozí hodnota je 100. Maximální hodnota je 1000.

  • max_ts
    Typ: integer Formát: int64

    Filtrujte položky před tímto unixovým časovým razítkem

  • min_ts
    Typ: integer Formát: int64

    Filtrujte položky po tomto unixovém časovém razítku

  • ticker
    Typ: string

    Filtrujte podle tickeru trhu

Odpovědi
  • 200
    Typ: object · Response24B585A0A861_GetTradesResponse

    Obchody úspěšně načteny

    • cursor
      Typ: string
      povinné
    • trades
      Typ: array object[] · Response24B585A0A861_Trade[]
      povinné
      • count_fp
        Typ: string · Response24B585A0A861_FixedPointCount
        povinné

        Řetězec počtu kontraktů s pevnou řádovou čárkou (2 desetinná místa, např. "10.00"; v názvech polí označovaný jako "fp"). Požadavky přijímají 0-2 desetinná místa (např. "10", "10.0", "10.00"); odpovědi vždy vracejí 2 desetinná místa. Zlomkové hodnoty kontraktů (např. "2.50") jsou podporovány; minimální granularita je 0,01 kontraktu.

      • created_time
        Typ: string Formát: date-time
        povinné

        Časové razítko, kdy byla tato transakce provedena

      • is_block_trade
        Typ: boolean
        povinné

        Hodnota true, pokud byla tato transakce spárována mimo knihu jako blokový obchod (např. prostřednictvím RFQ / vyjednaného blokového návrhu); false pro obchody provedené ve standardní knize objednávek.

      • no_price_dollars
        Typ: string · Response24B585A0A861_FixedPointDollars
        povinné

        Řetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.

      • taker_book_side
        Typ: string · Response24B585A0A861_BookSideenum
        povinné

        Strana knihy pro objednávku nebo obchod. U eventových trhů se týká pouze nohy YES: bid znamená koupit YES, ask znamená prodat YES. (Prodej YES je ekonomicky ekvivalentní koupi NO za 1 - price, ale tento endpoint oceňuje vše ze strany YES.)

        hodnoty
        • bid
        • ask
      • taker_outcome_side
        Typ: string enum
        povinné

        Strana výsledku, na kterou je taker pozicován. buy-yes a sell-no dávají 'yes'; buy-no a sell-yes dávají 'no'.

        taker_outcome_side popisuje pouze směrovou expozici; nemění cenu obchodu. Obchod za cenu p s taker_outcome_side=no se páruje s makerem za stejnou cenu p s opačným směrem — obě strany obchodují za stejnou cenu.

        taker_outcome_side a taker_book_side se stanou kanonickým způsobem určení směru obchodu. Starší pole taker_side bude v budoucím vydání označeno jako zastaralé — přejděte na tato nová pole.

        hodnoty
        • yes = TradeTakerOutcomeSideYes
        • no = TradeTakerOutcomeSideNo
      • ticker
        Typ: string
        povinné

        Jedinečný identifikátor trhu

      • trade_id
        Typ: string
        povinné

        Jedinečný identifikátor této transakce

      • yes_price_dollars
        Typ: string · Response24B585A0A861_FixedPointDollars
        povinné

        Řetězec částky v amerických dolarech s pevnou řádovou čárkou. Většina polí požadavku přijímá 2-4 desetinná místa (např. "0.56", "0.5600"); odpovědi vracejí až 6 desetinných míst. Platné intervaly kotací pro daný trh jsou omezeny strukturou cenových hladin tohoto trhu.

      • taker_side
        Typ: string enum
        zastaralé

        Zastaralé. Použijte místo toho taker_outcome_side (nebo taker_book_side). Viz Směr objednávky. Toto pole nebude odstraněno před 14. květnem 2026.

        hodnoty
        • yes = TradeTakerSideYes
        • no = TradeTakerSideNo
    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    application/json
Request Example for get/v1/beta/kalshi/trades
curl https://openapi.felo.ai/v1/beta/kalshi/trades \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "trades": [
    {
      "trade_id": "string",
      "ticker": "string",
      "count_fp": "10.00",
      "yes_price_dollars": "0.5600",
      "no_price_dollars": "0.5600",
      "taker_outcome_side": "yes",
      "taker_book_side": "bid",
      "created_time": "2026-10-26T08:08:16.607Z",
      "is_block_trade": true
    }
  ],
  "cursor": "string"
}
Get Kalshi Trades