kalshi

type Candlestick struct {
	EndPeriodTs    int64        `json:"end_period_ts"`
	YesBid         Ohlc         `json:"yes_bid"`
	YesAsk         Ohlc         `json:"yes_ask"`
	Price          OhlcExtended `json:"price"`
	Volume         int64        `json:"volume"`
	VolumeFp       string       `json:"volume_fp"`
	OpenInterest   int64        `json:"open_interest"`
	OpenInterestFp string       `json:"open_interest_fp"`
}

type Cents int

type Client struct {
	// BaseURL is one of APIDemoURL or APIProdURL.
	BaseURL string

	// See https://trading-api.readme.io/reference/tiers-and-rate-limits.
	WriteRatelimit *rate.Limiter
	ReadRateLimit  *rate.Limiter
	// contains filtered or unexported fields
}

type CreateOrderRequest struct {
	Action        OrderAction `json:"action,omitempty"`
	BuyMaxCost    Cents       `json:"buy_max_cost,omitempty"`
	Count         int         `json:"count,omitempty"`
	Expiration    *Timestamp  `json:"expiration_ts,omitempty"`
	NoPrice       Cents       `json:"no_price,omitempty"`
	YesPrice      Cents       `json:"yes_price,omitempty"`
	Ticker        string      `json:"ticker,omitempty"`
	ClientOrderID string      `json:"client_order_id,omitempty"`
	Type          OrderType   `json:"type"`
	Side          Side        `json:"side"`
}

type CursorRequest struct {
	Limit  int    `url:"limit,omitempty"`
	Cursor string `url:"cursor,omitempty"`
}

type CursorResponse struct {
	Cursor string `json:"cursor"`
}

type DecreaseOrderRequest struct {
	ReduceBy int `json:"reduce_by,omitempty"`
	ReduceTo int `json:"reduce_to,omitempty"`
}

type Event struct {
	Category          string    `json:"category"`
	EventTicker       string    `json:"event_ticker"`
	MutuallyExclusive bool      `json:"mutually_exclusive"`
	SeriesTicker      string    `json:"series_ticker"`
	StrikeDate        time.Time `json:"strike_date"`
	StrikePeriod      string    `json:"strike_period"`
	SubTitle          string    `json:"sub_title"`
	Title             string    `json:"title"`
}

type EventPosition struct {
	EventExposure     Cents  `json:"event_exposure"`
	EventTicker       string `json:"event_ticker"`
	FeesPaid          Cents  `json:"fees_paid"`
	RealizedPnl       Cents  `json:"realized_pnl"`
	RestingOrderCount int    `json:"resting_order_count"`
	TotalCost         Cents  `json:"total_cost"`
}

type EventResponse struct {
	Event   Event    `json:"event"`
	Markets []Market `json:"markets"`
}

type EventsRequest struct {
	CursorRequest
	// Status is one of "open", "closed", or "settled".
	Status       string `url:"status,omitempty"`
	SeriesTicker string `url:"series_ticker,omitempty"`
}

type EventsResponse struct {
	CursorResponse
	Events []Event `json:"events"`
}

type ExchangeScheduleResponse struct {
	Schedule struct {
		StandardHours struct {
			Monday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"monday"`
			Tuesday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"tuesday"`
			Wednesday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"wednesday"`
			Thursday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"thursday"`
			Friday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"friday"`
			Saturday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"saturday"`
			Sunday struct {
				OpenTime  string `json:"open_time"`
				CloseTime string `json:"close_time"`
			} `json:"sunday"`
		} `json:"standard_hours"`
		MaintenanceWindows []struct {
			EndDatetime   string `json:"end_datetime"`
			StartDatetime string `json:"start_datetime"`
		} `json:"maintenance_windows,omitempty"`
	} `json:"schedule"`
}

type ExchangeStatusResponse struct {
	ExchangeActive bool `json:"exchange_active,omitempty"`
	TradingActive  bool `json:"trading_active,omitempty"`
}

type Feed struct {
	// contains filtered or unexported fields
}

type Fill struct {
	Action      OrderAction `json:"action"`
	Count       int         `json:"count"`
	CreatedTime time.Time   `json:"created_time"`
	IsTaker     bool        `json:"is_taker"`
	NoPrice     Cents       `json:"no_price"`
	OrderID     string      `json:"order_id"`
	Side        Side        `json:"side"`
	Ticker      string      `json:"ticker"`
	TradeID     string      `json:"trade_id"`
	YesPrice    Cents       `json:"yes_price"`
}

type FillsRequest struct {
	CursorRequest
	Ticker  string    `url:"ticker,omitempty"`
	OrderID string    `url:"order_id,omitempty"`
	MinTS   Timestamp `url:"min_ts,omitempty"`
	MaxTS   Timestamp `url:"max_ts,omitempty"`
}

type FillsResponse struct {
	CursorResponse
	Fills []Fill `json:"fills"`
}

type GetMarketCandlesticksRequest struct {
	SeriesTicker             string `url:"-"`
	Ticker                   string `url:"-"`
	StartTs                  int64  `url:"start_ts,omitempty"`
	EndTs                    int64  `url:"end_ts,omitempty"`
	PeriodInterval           int    `url:"period_interval,omitempty"`
	IncludeLatestBeforeStart bool   `url:"include_latest_before_start,omitempty"`
}

type GetMarketCandlesticksResponse struct {
	Ticker       string        `json:"ticker"`
	Candlesticks []Candlestick `json:"candlesticks"`
}

type GetSeriesRequest struct {
	IncludeVolume bool `url:"include_volume,omitempty"`
}

type ListSeriesRequest struct {
	Category               string `url:"category,omitempty"`
	Tags                   string `url:"tags,omitempty"`
	IncludeProductMetadata bool   `url:"include_product_metadata,omitempty"`
	IncludeVolume          bool   `url:"include_volume,omitempty"`
}

type ListSeriesResponse struct {
	Series []Series `json:"series"`
}

type Market struct {
	Ticker                   string    `json:"ticker"`
	EventTicker              string    `json:"event_ticker"`
	MarketType               string    `json:"market_type"`
	Title                    string    `json:"title"`
	Subtitle                 string    `json:"subtitle"`
	YesSubTitle              string    `json:"yes_sub_title"`
	NoSubTitle               string    `json:"no_sub_title"`
	CreatedTime              time.Time `json:"created_time"`
	UpdatedTime              time.Time `json:"updated_time"`
	OpenTime                 time.Time `json:"open_time"`
	CloseTime                time.Time `json:"close_time"`
	ExpirationTime           time.Time `json:"expiration_time"`
	LatestExpirationTime     time.Time `json:"latest_expiration_time"`
	ExpectedExpirationTime   time.Time `json:"expected_expiration_time"`
	SettlementTimerSeconds   int       `json:"settlement_timer_seconds"`
	Status                   string    `json:"status"`
	ResponsePriceUnits       string    `json:"response_price_units"`
	YesBid                   Cents     `json:"yes_bid"`
	YesBidDollars            string    `json:"yes_bid_dollars"`
	YesAsk                   Cents     `json:"yes_ask"`
	YesAskDollars            string    `json:"yes_ask_dollars"`
	NoBid                    Cents     `json:"no_bid"`
	NoBidDollars             string    `json:"no_bid_dollars"`
	NoAsk                    Cents     `json:"no_ask"`
	NoAskDollars             string    `json:"no_ask_dollars"`
	LastPrice                Cents     `json:"last_price"`
	LastPriceDollars         string    `json:"last_price_dollars"`
	PreviousYesBid           Cents     `json:"previous_yes_bid"`
	PreviousYesBidDollars    string    `json:"previous_yes_bid_dollars"`
	PreviousYesAsk           Cents     `json:"previous_yes_ask"`
	PreviousYesAskDollars    string    `json:"previous_yes_ask_dollars"`
	PreviousPrice            Cents     `json:"previous_price"`
	PreviousPriceDollars     string    `json:"previous_price_dollars"`
	Volume                   int       `json:"volume"`
	VolumeFp                 string    `json:"volume_fp"`
	Volume24H                int       `json:"volume_24h"`
	Volume24HFp              string    `json:"volume_24h_fp"`
	Liquidity                Cents     `json:"liquidity"`
	LiquidityDollars         string    `json:"liquidity_dollars"`
	OpenInterest             int       `json:"open_interest"`
	OpenInterestFp           string    `json:"open_interest_fp"`
	NotionalValue            Cents     `json:"notional_value"`
	NotionalValueDollars     string    `json:"notional_value_dollars"`
	Result                   string    `json:"result"`
	CanCloseEarly            bool      `json:"can_close_early"`
	FractionalTradingEnabled bool      `json:"fractional_trading_enabled"`
	ExpirationValue          string    `json:"expiration_value"`
	SettlementValue          Cents     `json:"settlement_value"`
	SettlementValueDollars   string    `json:"settlement_value_dollars"`
	SettlementTs             time.Time `json:"settlement_ts"`
	FeeWaiverExpirationTime  time.Time `json:"fee_waiver_expiration_time"`
	EarlyCloseCondition      string    `json:"early_close_condition"`
	TickSize                 Cents     `json:"tick_size"`
	RulesPrimary             string    `json:"rules_primary"`
	RulesSecondary           string    `json:"rules_secondary"`
	PriceLevelStructure      string    `json:"price_level_structure"`
	PriceRanges              []struct {
		Start string `json:"start"`
		End   string `json:"end"`
		Step  string `json:"step"`
	} `json:"price_ranges"`
	StrikeType          string         `json:"strike_type"`
	FloorStrike         float64        `json:"floor_strike,omitempty"`
	CapStrike           float64        `json:"cap_strike,omitempty"`
	FunctionalStrike    string         `json:"functional_strike"`
	CustomStrike        map[string]any `json:"custom_strike"`
	MveCollectionTicker string         `json:"mve_collection_ticker"`
	MveSelectedLegs     []struct {
		EventTicker               string `json:"event_ticker"`
		MarketTicker              string `json:"market_ticker"`
		Side                      string `json:"side"`
		YesSettlementValueDollars string `json:"yes_settlement_value_dollars"`
	} `json:"mve_selected_legs"`
	PrimaryParticipantKey string `json:"primary_participant_key"`
	IsProvisional         bool   `json:"is_provisional"`
	Category              string `json:"category"`
	RiskLimit             Cents  `json:"risk_limit_cents"`
}

type MarketHistory struct {
	NoAsk        Cents     `json:"no_ask"`
	NoBid        Cents     `json:"no_bid"`
	OpenInterest int       `json:"open_interest"`
	Ts           Timestamp `json:"ts"`
	Volume       int       `json:"volume"`
	YesAsk       Cents     `json:"yes_ask"`
	YesBid       Cents     `json:"yes_bid"`
	YesPrice     Cents     `json:"yes_price"`
}

type MarketHistoryRequest struct {
	CursorRequest
	MinTS Timestamp `json:"min_ts,omitempty"`
	MaxTS Timestamp `json:"max_ts,omitempty"`
}

type MarketHistoryResponse struct {
	CursorResponse
	History []MarketHistory `json:"history"`
	Ticker  string          `json:"ticker"`
}

type MarketOrderBookResponse struct {
	OrderBook   OrderBook `json:"orderbook"`
	OrderBookFp struct {
		YesBidsDollars []OrderBookBidFp `json:"yes_dollars"`
		NoBidsDollars  []OrderBookBidFp `json:"no_dollars"`
	} `json:"orderbook_fp"`
}

type MarketPosition struct {
	// Fees paid on fill orders, in cents.
	FeesPaid Cents `json:"fees_paid"`
	// Number of contracts bought in this market. Negative means NO contracts and positive means YES contracts.
	Position int `json:"position"`
	// Locked in profit and loss, in cents.
	RealizedPnl Cents `json:"realized_pnl"`
	// Aggregate size of resting orders in contract units.
	RestingOrdersCount int `json:"resting_orders_count"`
	// Unique identifier for the market.
	Ticker string `json:"ticker"`
	// Total spent on this market in cents.
	TotalTraded Cents `json:"total_traded"`
	// Cost of the aggregate market position in cents.
	MarketExposure Cents `json:"market_exposure"`
}

type MarketsRequest struct {
	CursorRequest
	EventTicker  string `url:"event_ticker,omitempty"`
	SeriesTicker string `url:"series_ticker,omitempty"`
	MaxCloseTs   int    `url:"max_close_ts,omitempty"`
	MinCloseTs   int    `url:"min_close_ts,omitempty"`
	// Status is one of "open", "closed", and "settled"
	Status  string   `url:"status,omitempty"`
	Tickers []string `url:"status,omitempty"`
}

type MarketsResponse struct {
	Markets []Market `json:"markets,omitempty"`
	CursorResponse
}

type Ohlc struct {
	Open         int64  `json:"open"`
	OpenDollars  string `json:"open_dollars"`
	Low          int64  `json:"low"`
	LowDollars   string `json:"low_dollars"`
	High         int64  `json:"high"`
	HighDollars  string `json:"high_dollars"`
	Close        int64  `json:"close"`
	CloseDollars string `json:"close_dollars"`
}

type OhlcExtended struct {
	Ohlc
	Mean            int64  `json:"mean"`
	MeanDollars     string `json:"mean_dollars"`
	Previous        int64  `json:"previous"`
	PreviousDollars string `json:"previous_dollars"`
	Min             int64  `json:"min"`
	MinDollars      string `json:"min_dollars"`
	Max             int64  `json:"max"`
	MaxDollars      string `json:"max_dollars"`
}

type Order struct {
	Action           OrderAction `json:"action"`
	ClientOrderID    string      `json:"client_order_id"`
	CloseCancelCount int         `json:"close_cancel_count"`
	CreatedTime      *Time       `json:"created_time"`
	DecreaseCount    int         `json:"decrease_count"`
	ExpirationTime   *Time       `json:"expiration_time"`
	FccCancelCount   int         `json:"fcc_cancel_count"`
	LastUpdateTime   *Time       `json:"last_update_time"`
	MakerFillCost    int         `json:"maker_fill_cost"`
	MakerFillCount   int         `json:"maker_fill_count"`
	MakerFees        Cents       `json:"maker_fees"`
	NoPrice          Cents       `json:"no_price"`
	OrderID          string      `json:"order_id"`
	PlaceCount       int         `json:"place_count"`
	QueuePosition    int         `json:"queue_position"`
	RemainingCount   int         `json:"remaining_count"`
	Side             Side        `json:"side"`
	Status           OrderStatus `json:"status"`
	TakerFees        Cents       `json:"taker_fees"`
	TakerFillCost    Cents       `json:"taker_fill_cost"`
	TakerFillCount   int         `json:"taker_fill_count"`
	Ticker           string      `json:"ticker"`
	Type             OrderType   `json:"type"`
	UserID           string      `json:"user_id"`
	YesPrice         Cents       `json:"yes_price"`
}

type OrderAction string

type OrderBook struct {
	YesBids        OrderBookBids        `json:"yes"`
	NoBids         OrderBookBids        `json:"no"`
	YesBidsDollars []OrderBookBidDollar `json:"yes_dollars"`
	NoBidsDollars  []OrderBookBidDollar `json:"no_dollars"`
}

type OrderBookBid struct {
	Price    Cents
	Quantity int
}

type OrderBookBidDollar struct {
	Price    string
	Quantity int
}

type OrderBookBidFp struct {
	Price    string
	Quantity string
}

type OrderBookBids []OrderBookBid

type OrderStatus string

type OrderType string

type OrdersRequest struct {
	Ticker string      `url:"ticker,omitempty"`
	Status OrderStatus `url:"status,omitempty"`
}

type OrdersResponse struct {
	CursorResponse
	Orders []Order `json:"orders"`
}

type PositionsRequest struct {
	CursorRequest
	Limit            int              `url:"limit,omitempty"`
	SettlementStatus SettlementStatus `url:"settlement_status,omitempty"`
	Ticker           string           `url:"ticker,omitempty"`
	EventTicker      string           `url:"event_ticker,omitempty"`
}

type PositionsResponse struct {
	CursorResponse
	EventPositions  []EventPosition  `json:"event_positions"`
	MarketPositions []MarketPosition `json:"market_positions"`
}

type Series struct {
	Ticker                 string             `json:"ticker"`
	Frequency              string             `json:"frequency"`
	Title                  string             `json:"title"`
	Category               string             `json:"category"`
	Tags                   []string           `json:"tags"`
	SettlementSources      []SettlementSource `json:"settlement_sources"`
	ContractURL            string             `json:"contract_url"`
	ContractTermsURL       string             `json:"contract_terms_url"`
	FeeType                string             `json:"fee_type"`
	FeeMultiplier          float64            `json:"fee_multiplier"`
	AdditionalProhibitions []string           `json:"additional_prohibitions"`
	ProductMetadata        map[string]any     `json:"product_metadata"`
	Volume                 int                `json:"volume"`
	VolumeFp               string             `json:"volume_fp"`
}

type Settlement struct {
	MarketResult string    `json:"market_result"`
	NoCount      int       `json:"no_count"`
	NoTotalCost  int       `json:"no_total_cost"`
	Revenue      int       `json:"revenue"`
	SettledTime  time.Time `json:"settled_time"`
	Ticker       string    `json:"ticker"`
	YesCount     int       `json:"yes_count"`
	YesTotalCost int       `json:"yes_total_cost"`
}

type SettlementSource struct {
	Name string `json:"name"`
	URL  string `json:"url"`
}

type SettlementStatus string

type SettlementsRequest struct {
	CursorRequest
}

type SettlementsResponse struct {
	CursorResponse
	Settlements []Settlement `json:"settlements"`
}

type Side string

type StreamOrderBook struct {
	OrderBook
	LoadedAt time.Time
	// MarketID is included so multiple streaming order books can be multiplexed
	// onto one channel.
	MarketID string
}

type Time struct {
	time.Time
}

type Timestamp time.Time

type Trade struct {
	TradeID         string    `json:"trade_id"`
	Ticker          string    `json:"ticker"`
	Price           float64   `json:"price"`
	Count           int       `json:"count"`
	CountFp         string    `json:"count_fp"`
	YesPrice        Cents     `json:"yes_price"`
	NoPrice         Cents     `json:"no_price"`
	YesPriceDollars string    `json:"yes_price_dollars"`
	NoPriceDollars  string    `json:"no_price_dollars"`
	TakerSide       Side      `json:"taker_side"`
	CreatedTime     time.Time `json:"created_time"`
}

type TradesRequest struct {
	CursorRequest
	Ticker string `url:"ticker,omitempty"`
	MinTS  int    `url:"min_ts,omitempty"`
	MaxTS  int    `url:"max_ts,omitempty"`
}

type TradesResponse struct {
	CursorResponse
	Trades []Trade `json:"trades,omitempty"`
}