Felo API PlatformFelo API Platform
Semua endpoint Kalshi
v0.2.0-beta
OpenAPI 3.1.0

Ambil Perdagangan Kalshi

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

Kalshi

​

Prediction-market data.

Kalshi Operasi

Ambil Perdagangan Kalshi

​

Ambil rekaman perdagangan tereksekusi untuk pasar Kalshi — fill aktual, bukan kuotasi. Gunakan ini saat memerlukan harga terealisasi dan ukuran perdagangan dalam suatu jendela, misalnya untuk melihat bagaimana keyakinan bergerak saat suatu peristiwa berlangsung; persempit dengan ticker dan rentang detik Unix min_ts / max_ts, serta setel is_block_trade untuk mengisolasi perdagangan besar yang dinegosiasikan. Mengembalikan trades[] dengan trade_id, ticker, count_fp (kontrak), yes_price_dollars / no_price_dollars, taker_side, dan created_time, plus cursor untuk paginasi. Untuk kuotasi saat ini, aturan penyelesaian, dan metadata pasar alih-alih fill, gunakan get_kalshi_markets.

Referensi harga

  • Metering: Dasar biaya tetap per permintaan berhasil.
  • Estimasi referensi per permintaan: USD 0.02.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Kueri
  • cursor
    Tipe: string

    Kursor paginasi. Gunakan nilai kursor yang dikembalikan dari respons sebelumnya untuk mendapatkan halaman hasil berikutnya. Biarkan kosong untuk halaman pertama.

  • is_block_trade
    Tipe: boolean

    Filter perdagangan berdasarkan apakah itu perdagangan blok. Hilangkan untuk mengembalikan semua perdagangan. Setel ke true untuk hanya mengembalikan perdagangan blok. Setel ke false untuk hanya mengembalikan perdagangan non-blok.

  • limit
    Tipe: integer Format: int64
    min:  
    0
    maks:  
    1000

    Jumlah hasil per halaman. Default-nya 100. Nilai maksimum adalah 1000.

  • max_ts
    Tipe: integer Format: int64

    Filter item sebelum stempel waktu Unix ini

  • min_ts
    Tipe: integer Format: int64

    Filter item setelah stempel waktu Unix ini

  • ticker
    Tipe: string

    Filter berdasarkan ticker pasar

Respons
  • 200
    Tipe: object · Response24B585A0A861_GetTradesResponse

    Perdagangan berhasil diambil

    • cursor
      Tipe: string
      wajib
    • trades
      Tipe: array object[] · Response24B585A0A861_Trade[]
      wajib
      • count_fp
        Tipe: string · Response24B585A0A861_FixedPointCount
        wajib

        String jumlah kontrak titik tetap (2 desimal, misalnya "10.00"; disebut "fp" dalam nama field). Permintaan menerima 0-2 tempat desimal (misalnya "10", "10.0", "10.00"); respons selalu mengeluarkan 2 desimal. Nilai kontrak pecahan (misalnya "2.50") didukung; granularitas minimum adalah 0.01 kontrak.

      • created_time
        Tipe: string Format: date-time
        wajib

        Stempel waktu saat perdagangan ini dieksekusi

      • is_block_trade
        Tipe: boolean
        wajib

        True jika perdagangan ini dicocokkan di luar buku pesanan sebagai perdagangan blok (misalnya melalui RFQ / proposal perdagangan blok yang dinegosiasikan); false untuk perdagangan yang terisi di buku pesanan standar.

      • no_price_dollars
        Tipe: string · Response24B585A0A861_FixedPointDollars
        wajib

        String dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.

      • taker_book_side
        Tipe: string · Response24B585A0A861_BookSideenum
        wajib

        Sisi buku pesanan untuk order atau perdagangan. Untuk pasar peristiwa, ini hanya merujuk pada leg YES: bid berarti beli YES, ask berarti jual YES. (Menjual YES secara ekonomi setara dengan membeli NO pada 1 - price, tetapi endpoint ini mengutip semuanya dari sisi YES.)

        nilai
        • bid
        • ask
      • taker_outcome_side
        Tipe: string enum
        wajib

        Sisi hasil yang menjadi posisi taker. buy-yes dan sell-no menghasilkan 'yes'; buy-no dan sell-yes menghasilkan 'no'.

        taker_outcome_side hanya menggambarkan eksposur arah; ini tidak mengubah harga perdagangan. Perdagangan pada harga p dengan taker_outcome_side=no dicocokkan dengan maker pada harga p yang sama dengan arah berlawanan — kedua pihak berdagang pada harga yang sama.

        taker_outcome_side dan taker_book_side akan menjadi cara kanonis untuk menentukan arah perdagangan. Field lama taker_side akan dihentikan pada rilis mendatang — silakan beralih ke field baru ini.

        nilai
        • yes = TradeTakerOutcomeSideYes
        • no = TradeTakerOutcomeSideNo
      • ticker
        Tipe: string
        wajib

        Pengenal unik untuk pasar

      • trade_id
        Tipe: string
        wajib

        Pengenal unik untuk perdagangan ini

      • yes_price_dollars
        Tipe: string · Response24B585A0A861_FixedPointDollars
        wajib

        String dolar AS titik tetap. Sebagian besar field permintaan menerima 2-4 tempat desimal (misalnya "0.56", "0.5600"); respons mengeluarkan hingga 6. Interval kuotasi yang valid untuk pasar tertentu dibatasi oleh struktur tingkat harga pasar tersebut.

      • taker_side
        Tipe: string enum
        usang

        Usang. Gunakan taker_outcome_side (atau taker_book_side) sebagai gantinya. Lihat Arah pesanan. Field ini tidak akan dihapus sebelum 14 Mei 2026.

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

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    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.678Z",
      "is_block_trade": true
    }
  ],
  "cursor": "string"
}

Perdagangan berhasil diambil

Get Kalshi Trades