{"uid":"cap_zm-QoHVgfpx8uyS_xOw-A","slug":"aisa-mpp-data-apis-kalshi-markets-listing-api-eefbbd8e","name":"Kalshi Markets Listing API","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/markets?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},"status":{"enum":["unopened","open","paused","closed","settled"],"type":"string","description":"Filter by market status. Leave empty to return markets with any status."},"tickers":{"type":"string","description":"Filter by specific market tickers. Comma-separated list of market tickers to retrieve."},"mve_filter":{"enum":["only","exclude"],"type":"string","description":"Filter by multivariate events (combos). 'only' returns only multivariate events, 'exclude' excludes multivariate events."},"event_ticker":{"type":"string","description":"Event ticker to filter by. Only a single event ticker is supported.","x-go-type-skip-optional-pointer":true},"max_close_ts":{"type":"integer","format":"int64","description":"Filter items that close before this Unix timestamp"},"min_close_ts":{"type":"integer","format":"int64","description":"Filter items that close after this Unix timestamp"},"series_ticker":{"type":"string","description":"Filter by series ticker","x-go-type-skip-optional-pointer":true},"max_created_ts":{"type":"integer","format":"int64","description":"Filter items that created before this Unix timestamp"},"max_settled_ts":{"type":"integer","format":"int64","description":"Filter items that settled before this Unix timestamp"},"max_updated_ts":{"type":"integer","format":"int64","description":"Return markets with metadata updated at or before this Unix timestamp (in seconds). Tracks non-trading changes only. May be combined with min_updated_ts and mve_filter=exclude. May also be combined with series_ticker, which requires mve_filter=exclude. Incompatible with other filters."},"min_created_ts":{"type":"integer","format":"int64","description":"Filter items that created after this Unix timestamp"},"min_settled_ts":{"type":"integer","format":"int64","description":"Filter items that settled after this Unix timestamp"},"min_updated_ts":{"type":"integer","format":"int64","description":"Return markets with metadata updated later than this Unix timestamp (in seconds). Tracks non-trading changes only. May be combined with max_updated_ts and mve_filter=exclude. May also be combined with series_ticker, which requires mve_filter=exclude. Incompatible with other filters."}}},"responseSchema":{"type":"object","required":["markets","cursor"],"properties":{"cursor":{"type":"string"},"markets":{"type":"array","items":{"type":"object","required":["ticker","event_ticker","market_type","yes_sub_title","no_sub_title","created_time","updated_time","open_time","close_time","latest_expiration_time","settlement_timer_seconds","status","notional_value_dollars","yes_bid_dollars","yes_ask_dollars","no_bid_dollars","no_ask_dollars","yes_bid_size_fp","yes_ask_size_fp","last_price_dollars","previous_yes_bid_dollars","previous_yes_ask_dollars","previous_price_dollars","volume_fp","volume_24h_fp","open_interest_fp","result","can_close_early","expiration_value","rules_primary","rules_secondary","price_level_structure","price_ranges","settlement_bounds_type"],"properties":{"title":{"type":"string","deprecated":true,"x-go-type-skip-optional-pointer":true},"result":{"enum":["yes","no","scalar",""],"type":"string"},"status":{"enum":["initialized","inactive","active","closed","determined","disputed","amended","finalized"],"type":"string","description":"The current status of the market in its lifecycle."},"ticker":{"type":"string"},"subtitle":{"type":"string","deprecated":true,"x-go-type-skip-optional-pointer":true},"open_time":{"type":"string","format":"date-time"},"volume_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."},"cap_strike":{"type":["number","null"],"format":"double","description":"Maximum expiration value that leads to a YES settlement","x-omitempty":true},"close_time":{"type":"string","format":"date-time"},"market_type":{"enum":["binary","scalar"],"type":"string","description":"Identifies the type of market"},"strike_type":{"enum":["greater","greater_or_equal","less","less_or_equal","between","functional","custom","structured"],"type":"string","description":"Strike type defines how the market strike is defined and evaluated","x-omitempty":true,"x-go-type-skip-optional-pointer":true},"created_time":{"type":"string","format":"date-time"},"event_ticker":{"type":"string"},"floor_strike":{"type":["number","null"],"format":"double","description":"Minimum expiration value that leads to a YES settlement","x-omitempty":true},"no_sub_title":{"type":"string","description":"Shortened title for the no side of this market"},"price_ranges":{"type":"array","items":{"type":"object","required":["start","end","step"],"properties":{"end":{"type":"string","description":"Ending price for this range in dollars"},"step":{"type":"string","description":"Price step/tick size for this range in dollars"},"start":{"type":"string","description":"Starting price for this range in dollars"}}},"description":"Valid price ranges for orders on this market"},"updated_time":{"type":"string","format":"date-time","description":"Time of the last non-trading metadata update."},"custom_strike":{"type":["object","null"],"description":"Expiration value for each target that leads to a YES settlement","x-omitempty":true},"rules_primary":{"type":"string","description":"A plain language description of the most important market terms"},"settlement_ts":{"type":["string","null"],"format":"date-time","description":"Timestamp when the market was settled. Only filled for settled markets","x-omitempty":true},"volume_24h_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."},"yes_sub_title":{"type":"string","description":"Shortened title for the yes side of this market"},"exchange_index":{"allOf":[{"type":"integer","example":0,"description":"Identifier for an exchange shard."}],"x-omitempty":false,"x-go-type-skip-optional-pointer":true},"is_provisional":{"type":"boolean","description":"If true, the market may be removed after determination if there is no activity on it","x-omitempty":true,"x-go-type-skip-optional-pointer":true},"no_ask_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."},"no_bid_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."},"can_close_early":{"type":"boolean"},"expiration_time":{"type":"string","format":"date-time","deprecated":true,"x-go-type-skip-optional-pointer":true},"rules_secondary":{"type":"string","description":"A plain language description of secondary market terms"},"yes_ask_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_ask_size_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."},"yes_bid_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_bid_size_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."},"expiration_value":{"type":"string","description":"The value that was considered for the settlement"},"open_interest_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."},"functional_strike":{"type":["string","null"],"description":"Mapping from expiration values to settlement values","x-omitempty":true},"mve_selected_legs":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string","description":"The side of the selected market","x-go-type-skip-optional-pointer":true},"event_ticker":{"type":"string","description":"Unique identifier for the selected event","x-go-type-skip-optional-pointer":true},"market_ticker":{"type":"string","description":"Unique identifier for the selected market","x-go-type-skip-optional-pointer":true},"yes_settlement_value_dollars":{"$ref":"#/components/schemas/kalshi_unauthorized_4c4ca4fdc8b8__Response4124E7F6C935_FixedPointDollars"}}},"x-omitempty":true,"x-go-type-skip-optional-pointer":true},"last_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."},"occurrence_datetime":{"type":["string","null"],"format":"date-time","description":"The recorded datetime when the underlying event occurred, if available"},"early_close_condition":{"type":["string","null"],"description":"The condition under which the market can close early","x-omitempty":true,"x-go-type-skip-optional-pointer":true},"mve_collection_ticker":{"type":"string","description":"The ticker of the multivariate event collection","x-omitempty":true,"x-go-type-skip-optional-pointer":true},"price_level_structure":{"type":"string","description":"Price level structure for this market, defining price ranges and tick sizes"},"latest_expiration_time":{"type":"string","format":"date-time","description":"Latest possible time for this market to expire"},"notional_value_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."},"previous_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."},"settlement_bounds_type":{"enum":["default","floor"],"type":"string","description":"Which settlement bounds apply to this market. default means the market has no settlement bounds"},"primary_participant_key":{"type":["string","null"],"x-omitempty":true},"expected_expiration_time":{"type":["string","null"],"format":"date-time","description":"Time when this market is expected to expire","x-omitempty":true},"previous_yes_ask_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."},"previous_yes_bid_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."},"settlement_floor_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."},"settlement_timer_seconds":{"type":"integer","description":"The amount of time after determination that the market settles"},"settlement_value_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."},"fee_waiver_expiration_time":{"type":["string","null"],"format":"date-time","description":"Time when this market's fee waiver expires","x-omitempty":true}}}}}},"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_Gzv2fp7vNAeYjdNYHZkWq","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 Kalshi prediction market contracts with filtering by status, ticker, event, series, and time ranges","exampleAgentPrompt":"Show me all open Kalshi prediction markets for the 2024 US election series — return up to 200 results.","exampleUseCases":[{"title":"Monitor active political prediction markets","prompt":"Pull all currently open Kalshi markets in the ELECTIONS series and show me their yes/no prices and 24-hour volume."},{"title":"Find markets closing this week","prompt":"List any Kalshi prediction markets that are still open and closing before next Friday — I want to see what's still tradeable."},{"title":"Track settlement results for past markets","prompt":"Get the settled Kalshi markets from the CRYPTO series and tell me which ones resolved yes versus no, along with their final prices."}],"resultDescription":"Returns a paginated array of market objects, each containing ticker, event ticker, market type (binary or scalar), yes/no bid and ask prices in dollars, last traded price, 24-hour volume, open interest, open/close times, current status, settlement result, expiration value, and market rules. Also returns a cursor string for fetching the next page.","failureModes":["Invalid or unknown ticker returns empty markets array","Incompatible filter combinations (e.g. max_updated_ts with other filters) return 400 error","Limit exceeds maximum of 1000 returns validation error","Invalid status enum value returns 400 bad request","Expired or invalid cursor returns empty or first-page results","Rate limiting or quota exhaustion returns 429 error"],"whenToPreferThis":"Use this endpoint when you need to discover, browse, or filter Kalshi prediction market contracts programmatically — especially when filtering by status, event, series, or time range. Prefer this over direct Kalshi API access when you need pay-per-call access without managing Kalshi credentials. Best for agents that need to scan available markets, monitor price levels, or find specific contracts by ticker.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:40:43.858Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-kalshi-markets-listing-api-eefbbd8e"}