{"uid":"cap_6vVnrzuhsOzuP7ehZD907","slug":"aisa-mpp-data-apis-kalshi-trades-feed-f5b15568","name":"Kalshi Trades Feed","description":"默认价格配置\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/kalshi/trades?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","default":100,"maximum":1000,"minimum":0,"description":"Number of results per page. Defaults to 100. Maximum value is 1000.","x-oapi-codegen-extra-tags":{"validate":"omitempty,gte=0,lte=1000"}},"cursor":{"type":"string","description":"Pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.","x-go-type-skip-optional-pointer":true},"max_ts":{"type":"integer","format":"int64","description":"Filter items before this Unix timestamp"},"min_ts":{"type":"integer","format":"int64","description":"Filter items after this Unix timestamp"},"ticker":{"type":"string","description":"Filter by market ticker","x-go-type-skip-optional-pointer":true},"is_block_trade":{"type":"boolean","description":"Filter trades by whether they are block trades. Omit to return all trades. Set to `true` to return only block trades. Set to `false` to return only non-block trades.\n"}}},"responseSchema":{"type":"object","required":["trades","cursor"],"properties":{"cursor":{"type":"string"},"trades":{"type":"array","items":{"type":"object","required":["trade_id","ticker","count_fp","yes_price_dollars","no_price_dollars","taker_outcome_side","taker_book_side","created_time","is_block_trade"],"properties":{"ticker":{"type":"string","description":"Unique identifier for the market"},"count_fp":{"type":"string","example":"10.00","description":"Fixed-point contract count string (2 decimals, e.g., \"10.00\"; referred to as \"fp\" in field names). Requests accept 0-2 decimal places (e.g., \"10\", \"10.0\", \"10.00\"); responses always emit 2 decimals. Fractional contract values (e.g., \"2.50\") are supported; the minimum granularity is 0.01 contracts."},"trade_id":{"type":"string","description":"Unique identifier for this trade"},"taker_side":{"enum":["yes","no"],"type":"string","deprecated":true,"description":"Deprecated. Use `taker_outcome_side` (or `taker_book_side`) instead. See [Order direction](/getting_started/order_direction). This field will not be removed before May 14, 2026.\n","x-enum-varnames":["TradeTakerSideYes","TradeTakerSideNo"],"x-go-type-skip-optional-pointer":true},"created_time":{"type":"string","format":"date-time","description":"Timestamp when this trade was executed"},"is_block_trade":{"type":"boolean","description":"True if this trade was matched off-book as a block trade (e.g. via RFQ / negotiated block proposal); false for trades that filled on the standard order book."},"taker_book_side":{"enum":["bid","ask"],"type":"string","description":"Side of the book for an order or trade. For event markets, this refers to the YES leg only: `bid` means buy YES, `ask` means sell YES. (Selling YES is economically equivalent to buying NO at `1 - price`, but this endpoint quotes everything from the YES side.)"},"no_price_dollars":{"type":"string","example":"0.5600","description":"Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., \"0.56\", \"0.5600\"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure."},"yes_price_dollars":{"type":"string","example":"0.5600","description":"Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., \"0.56\", \"0.5600\"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure."},"taker_outcome_side":{"enum":["yes","no"],"type":"string","description":"The outcome side the taker is positioned for. buy-yes and sell-no produce 'yes'; buy-no and sell-yes produce 'no'.\n\n`taker_outcome_side` describes directional exposure only; it does not change the trade's price. A trade at price `p` with `taker_outcome_side=no` is matched against the maker at the same price `p` with the opposite direction — both parties trade at the same price.\n\n`taker_outcome_side` and `taker_book_side` will become the canonical way to determine trade direction. The legacy `taker_side` field will be deprecated in a future release — please migrate to these new fields.\n","x-enum-varnames":["TradeTakerOutcomeSideYes","TradeTakerOutcomeSideNo"]}}}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FVaLLqZAall9d-Zp01_GY","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of executed trades on Kalshi prediction markets, filterable by market ticker, timestamp range, and block trade status.","exampleAgentPrompt":"Pull the last 50 trades for the Kalshi market ticker INXD-23DEC31-B4800 and show me the yes prices and contract counts — only non-block trades.","exampleUseCases":[{"title":"Monitor live trading activity on an event market","prompt":"Show me the 100 most recent trades on the Kalshi PRES-2024-DEM market so I can see what prices contracts are currently changing hands at."},{"title":"Audit block trade history for a market","prompt":"Fetch all block trades for the Kalshi ticker FED-24DEC between Unix timestamps 1700000000 and 1710000000 so I can review large off-book transactions."},{"title":"Backfill trade data for price analysis","prompt":"I need the full trade history for the Kalshi HIGHNY-24JAN market from midnight Jan 1 to midnight Jan 31 — give me up to 1000 results per page starting from the beginning."}],"resultDescription":"Returns a paginated array of trade objects, each containing a unique trade ID, market ticker, fixed-point contract count, yes and no prices in dollars, taker outcome side (yes/no), taker book side (bid/ask), execution timestamp, and a block trade flag. Also includes a pagination cursor for fetching subsequent pages.","failureModes":["Invalid or unknown ticker returns empty trades array","timestamp filters with min_ts > max_ts may return no results or an error","limit values outside 0–1000 are rejected with a validation error","stale or invalid cursor may return an error or restart pagination","omitting required auth credentials returns a 401 unauthorized error"],"whenToPreferThis":"Use this endpoint when you need granular, per-trade execution data from Kalshi prediction markets — including exact prices, contract counts, and whether trades were executed on the order book or as block trades. Prefer this over a markets or prices endpoint when you need the actual transaction record rather than aggregate or current market state. Ideal for auditing trade flow, backtesting pricing models, or monitoring real-time activity on specific markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:53:10.981Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-kalshi-trades-feed-f5b15568"}