curl --request POST \
--url https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets \
--header 'Content-Type: application/json' \
--header 'KALSHI-ACCESS-KEY: <api-key>' \
--header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
--header 'KALSHI-ACCESS-TIMESTAMP: <api-key>' \
--data '
{
"carrier": "AA",
"flight_number": "100",
"departure_airport": "JFK",
"arrival_airport": "LHR",
"scheduled_date": "2026-11-25",
"delay_minutes": 120
}
'import requests
url = "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets"
payload = {
"carrier": "AA",
"flight_number": "100",
"departure_airport": "JFK",
"arrival_airport": "LHR",
"scheduled_date": "2026-11-25",
"delay_minutes": 120
}
headers = {
"KALSHI-ACCESS-KEY": "<api-key>",
"KALSHI-ACCESS-SIGNATURE": "<api-key>",
"KALSHI-ACCESS-TIMESTAMP": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'KALSHI-ACCESS-KEY': '<api-key>',
'KALSHI-ACCESS-SIGNATURE': '<api-key>',
'KALSHI-ACCESS-TIMESTAMP': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
carrier: 'AA',
flight_number: '100',
departure_airport: 'JFK',
arrival_airport: 'LHR',
scheduled_date: '2026-11-25',
delay_minutes: 120
})
};
fetch('https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'carrier' => 'AA',
'flight_number' => '100',
'departure_airport' => 'JFK',
'arrival_airport' => 'LHR',
'scheduled_date' => '2026-11-25',
'delay_minutes' => 120
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"KALSHI-ACCESS-KEY: <api-key>",
"KALSHI-ACCESS-SIGNATURE: <api-key>",
"KALSHI-ACCESS-TIMESTAMP: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets"
payload := strings.NewReader("{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("KALSHI-ACCESS-KEY", "<api-key>")
req.Header.Add("KALSHI-ACCESS-SIGNATURE", "<api-key>")
req.Header.Add("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets")
.header("KALSHI-ACCESS-KEY", "<api-key>")
.header("KALSHI-ACCESS-SIGNATURE", "<api-key>")
.header("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["KALSHI-ACCESS-KEY"] = '<api-key>'
request["KALSHI-ACCESS-SIGNATURE"] = '<api-key>'
request["KALSHI-ACCESS-TIMESTAMP"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}"
response = http.request(request)
puts response.read_body{
"cover": "cancelled",
"event_ticker": "KXRFQFLIGHTD-AA100-JFKLHR-26NOV25",
"market_ticker": "KXRFQFLIGHTD-AA100-JFKLHR-26NOV25-DEP120",
"created": true,
"delay_basis": "departure",
"delay_minutes": 120
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}Create Flight Disruption Market
Returns the on-request market on whether a flight is canceled or
delayed, creating it if it doesn’t exist yet. A market is defined by
the flight (carrier, flight_number, departure_airport,
arrival_airport and scheduled_date), the cover (cancelled,
delayed or either) and, for delayed and either, the
delay_basis and delay_minutes. The same request always returns the
same market, so call this before sending an RFQ for a market you
haven’t seen. created tells you whether the market is new.
Take the flight’s five fields from
GET /flight_disruption_markets/flights. A flight is one nonstop leg:
a flight number that flies several legs in a day is several flights.
carrier and flight_number are the operating carrier’s, which the
lookup returns even when you searched by a codeshare number.
delay_minutes is a multiple of delay_step_minutes, up to
max_delay_minutes, both from
GET /flight_disruption_markets/availability. A cancelled market
takes neither delay_basis nor delay_minutes.
An existing market is returned until it closes, even when new markets
are no longer offered. A new market’s flight must be scheduled to
leave more than min_lead_minutes from now and within
max_days_ahead days, from an airport in one of
departure_countries.
A market is traded through RFQs: pass the returned market_ticker to
POST /communications/rfqs. These markets are in series starting with
KXRFQ and are left out of unscoped market listings.
A market created a moment ago may not be readable yet: if
GET /markets/{ticker} returns 404 right after creation, retry.
Errors carry the specific reason in details:
| Status | code | When |
|---|---|---|
| 400 | bad_request | The body isn’t valid JSON, or a field has the wrong type. |
| 400 | missing_parameters | A required field is missing or empty. |
| 400 | invalid_parameters | A field is present but unusable: an unknown cover or delay basis, a carrier, flight number or airport code of the wrong form, a scheduled_date that isn’t YYYY-MM-DD, a delayed or either request without delay_basis and delay_minutes, a cancelled request with either of them, a delay_minutes that isn’t a multiple of delay_step_minutes or is above max_delay_minutes, or a flight scheduled further ahead than max_days_ahead. |
| 404 | not_found | No such flight is scheduled on that date. |
| 409 | flight_disruption_market_unavailable | The request is valid but the market isn’t offered: flight markets or the cover are switched off, the flight leaves too soon, departs from a country that isn’t offered, or its market has closed. |
| 429 | flight_disruption_market_limit_exceeded | A limit on new flight markets was reached. Retrying at once doesn’t help. |
| 429 | too_many_requests | Your API rate limit. This endpoint is charged against your write budget. |
curl --request POST \
--url https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets \
--header 'Content-Type: application/json' \
--header 'KALSHI-ACCESS-KEY: <api-key>' \
--header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
--header 'KALSHI-ACCESS-TIMESTAMP: <api-key>' \
--data '
{
"carrier": "AA",
"flight_number": "100",
"departure_airport": "JFK",
"arrival_airport": "LHR",
"scheduled_date": "2026-11-25",
"delay_minutes": 120
}
'import requests
url = "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets"
payload = {
"carrier": "AA",
"flight_number": "100",
"departure_airport": "JFK",
"arrival_airport": "LHR",
"scheduled_date": "2026-11-25",
"delay_minutes": 120
}
headers = {
"KALSHI-ACCESS-KEY": "<api-key>",
"KALSHI-ACCESS-SIGNATURE": "<api-key>",
"KALSHI-ACCESS-TIMESTAMP": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'KALSHI-ACCESS-KEY': '<api-key>',
'KALSHI-ACCESS-SIGNATURE': '<api-key>',
'KALSHI-ACCESS-TIMESTAMP': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
carrier: 'AA',
flight_number: '100',
departure_airport: 'JFK',
arrival_airport: 'LHR',
scheduled_date: '2026-11-25',
delay_minutes: 120
})
};
fetch('https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'carrier' => 'AA',
'flight_number' => '100',
'departure_airport' => 'JFK',
'arrival_airport' => 'LHR',
'scheduled_date' => '2026-11-25',
'delay_minutes' => 120
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"KALSHI-ACCESS-KEY: <api-key>",
"KALSHI-ACCESS-SIGNATURE: <api-key>",
"KALSHI-ACCESS-TIMESTAMP: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets"
payload := strings.NewReader("{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("KALSHI-ACCESS-KEY", "<api-key>")
req.Header.Add("KALSHI-ACCESS-SIGNATURE", "<api-key>")
req.Header.Add("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets")
.header("KALSHI-ACCESS-KEY", "<api-key>")
.header("KALSHI-ACCESS-SIGNATURE", "<api-key>")
.header("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://external-api.kalshi.com/trade-api/v2/flight_disruption_markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["KALSHI-ACCESS-KEY"] = '<api-key>'
request["KALSHI-ACCESS-SIGNATURE"] = '<api-key>'
request["KALSHI-ACCESS-TIMESTAMP"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"carrier\": \"AA\",\n \"flight_number\": \"100\",\n \"departure_airport\": \"JFK\",\n \"arrival_airport\": \"LHR\",\n \"scheduled_date\": \"2026-11-25\",\n \"delay_minutes\": 120\n}"
response = http.request(request)
puts response.read_body{
"cover": "cancelled",
"event_ticker": "KXRFQFLIGHTD-AA100-JFKLHR-26NOV25",
"market_ticker": "KXRFQFLIGHTD-AA100-JFKLHR-26NOV25-DEP120",
"created": true,
"delay_basis": "departure",
"delay_minutes": 120
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}{
"code": "<string>",
"message": "<string>",
"details": "<string>"
}Authorizations
Body
What a flight disruption market pays on, read from the flight's status after it was scheduled to arrive:
cancelled: Yes when the flight is canceled.delayed: Yes when the flight operates and is at leastdelay_minuteslate on itsdelay_basis. A canceled flight resolves to No.either: Yes in both of those cases.
cancelled, delayed, either Response
Market returned or created successfully
What a flight disruption market pays on, read from the flight's status after it was scheduled to arrive:
cancelled: Yes when the flight is canceled.delayed: Yes when the flight operates and is at leastdelay_minuteslate on itsdelay_basis. A canceled flight resolves to No.either: Yes in both of those cases.
cancelled, delayed, either