clob

type APIError struct {
	StatusCode int
	Message    string
	Body       []byte
}

type AssetType string

type Auth struct {
	Signer        *polyauth.Signer
	ChainID       int64
	Credentials   *Credentials
	UseServerTime bool
}

type BalanceAllowanceParams struct {
	// AssetType specifies collateral or conditional.
	AssetType AssetType `json:"asset_type" url:"asset_type"`
	// TokenID is the conditional token (required for conditional assets).
	TokenID string `json:"token_id,omitempty" url:"token_id,omitempty"`
	// SignatureType identifies the signature method.
	SignatureType SignatureType `json:"signature_type,omitempty" url:"signature_type,omitempty"`
}

type BalanceAllowanceResponse struct {
	// Balance is the current token balance.
	Balance Float64 `json:"balance"`
	// Allowance is the approved amount for the exchange contract.
	Allowance Float64 `json:"allowance,omitempty"`
	// Allowances maps spender addresses to approved amounts.
	Allowances map[string]string `json:"allowances,omitempty"`
}

type BanStatus struct {
	// ClosedOnly is true when the account can only reduce positions.
	ClosedOnly bool `json:"closed_only"`
}

type BatchPriceHistoryParams struct {
	// Markets lists the condition IDs to query.
	Markets []string `json:"markets"`
	// StartTS is the start Unix timestamp.
	StartTS int64 `json:"start_ts,omitempty"`
	// EndTS is the end Unix timestamp.
	EndTS int64 `json:"end_ts,omitempty"`
	// Fidelity controls the data point density.
	Fidelity int `json:"fidelity,omitempty"`
	// Interval sets the bucket size (e.g. "5m", "1h").
	Interval string `json:"interval,omitempty"`
}

type BatchPriceHistoryResponse struct {
	History map[string][]PricePoint `json:"history"`
}

type BookParams struct {
	// TokenID is the conditional token identifier.
	TokenID string `json:"token_id" url:"token_id"`
	// Side filters by buy or sell, empty means both.
	Side Side `json:"side,omitempty" url:"side,omitempty"`
}

type BuilderAPIKey struct {
	// Key is the API key value.
	Key string `json:"key"`
	// CreatedAt is when the key was created.
	CreatedAt Time `json:"createdAt"`
	// RevokedAt is when the key was revoked, zero if active.
	RevokedAt Time `json:"revokedAt"`
}

type BuilderFeeRate struct {
	// BuilderMakerFeeRateBps is the maker fee in basis points.
	BuilderMakerFeeRateBps Int `json:"builderMakerFeeRateBps"`
	// BuilderTakerFeeRateBps is the taker fee in basis points.
	BuilderTakerFeeRateBps Int `json:"builderTakerFeeRateBps"`
}

type BuilderTrade struct {
	// ID is the trade identifier.
	ID string `json:"id"`
	// TradeType identifies the trade category.
	TradeType string `json:"tradeType"`
	// TakerOrderHash is the taker order hash.
	TakerOrderHash string `json:"takerOrderHash"`
	// Builder is the builder code.
	Builder string `json:"builder"`
	// Market is the condition ID.
	Market string `json:"market"`
	// AssetID is the conditional token identifier.
	AssetID String `json:"assetId"`
	// Side is the trade direction.
	Side Side `json:"side"`
	// Size is the matched quantity.
	Size Float64 `json:"size"`
	// SizeUSDC is the quantity in USDC.
	SizeUSDC Float64 `json:"sizeUsdc"`
	// Price is the execution price.
	Price Float64 `json:"price"`
	// Status is the trade processing status.
	Status string `json:"status"`
	// Outcome is the outcome label.
	Outcome string `json:"outcome"`
	// OutcomeIndex is the 0-based index of the outcome.
	OutcomeIndex Int `json:"outcomeIndex"`
	// Owner is the trade owner address.
	Owner string `json:"owner"`
	// Maker is the maker wallet address.
	Maker string `json:"maker"`
	// TransactionHash is the on-chain transaction hash.
	TransactionHash string `json:"transactionHash"`
	// MatchTime is when the trade was matched.
	MatchTime Time `json:"matchTime"`
	// BucketIndex is the price bucket index.
	BucketIndex Int `json:"bucketIndex"`
	// Fee is the fee amount.
	Fee Float64 `json:"fee"`
	// FeeUSDC is the fee in USDC.
	FeeUSDC Float64 `json:"feeUsdc"`
	// ErrMsg contains error details on failure.
	ErrMsg string `json:"errMsg"`
	// CreatedAt is when the trade record was created.
	CreatedAt Time `json:"createdAt"`
	// UpdatedAt is the last record update.
	UpdatedAt Time `json:"updatedAt"`
}

type BuilderTradeParams struct {
	// ID filters by trade identifier.
	ID string `url:"id,omitempty"`
	// MakerAddress filters by maker wallet address.
	MakerAddress string `url:"maker,omitempty"`
	// Market filters by condition ID.
	Market string `url:"market,omitempty"`
	// AssetID filters by conditional token identifier.
	AssetID string `url:"asset_id,omitempty"`
	// Before filters trades before this Unix timestamp.
	Before int64 `url:"before,omitempty"`
	// After filters trades after this Unix timestamp.
	After int64 `url:"after,omitempty"`
	// BuilderCode filters by builder attribution code.
	BuilderCode string `url:"builder_code,omitempty"`
	// NextCursor is the pagination cursor.
	NextCursor string `url:"next_cursor,omitempty"`
}

type CTFTransaction struct {
	// To is the contract address that should receive the transaction.
	To common.Address
	// Data is the ABI-encoded calldata.
	Data []byte
}

type CancelOrdersResponse struct {
	// Canceled lists successfully canceled order IDs.
	Canceled []string `json:"canceled"`
	// NotCanceled maps failed order IDs to error messages.
	NotCanceled map[string]string `json:"not_canceled"`
}

type CancelRFQQuoteRequest struct {
	// QuoteID identifies the quote to cancel.
	QuoteID string `json:"quoteId"`
}

type CancelRFQRequest struct {
	// RequestID identifies the RFQ to cancel.
	RequestID string `json:"requestId"`
}

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

type ClobMarketInfo struct {
	// ConditionID is the CTF condition identifier.
	ConditionID string `json:"c"`
	// MinimumTickSize is the price increment granularity.
	MinimumTickSize Float64 `json:"mts"`
	// MinimumOrderSize is the smallest allowed order.
	MinimumOrderSize Float64 `json:"mos"`
	// NegRisk indicates a negative-risk market resolution.
	NegRisk bool `json:"nr"`
	// FeeDetails describes the fee structure.
	FeeDetails FeeInfo `json:"fd"`
	// Tokens lists the conditional outcome tokens.
	Tokens []ClobMarketToken `json:"t"`
	// RFQEnabled indicates request-for-quote is active.
	RFQEnabled bool `json:"rfqe"`
	// MakerBaseFee is the maker fee rate.
	MakerBaseFee Float64 `json:"mbf"`
	// TakerBaseFee is the taker fee rate.
	TakerBaseFee Float64 `json:"tbf"`
}

type ClobMarketToken struct {
	// TokenID is the conditional token identifier.
	TokenID String `json:"t"`
	// Outcome is the outcome label.
	Outcome string `json:"o"`
}

type ContractConfig struct {
	// Exchange is the CTF Exchange V2 contract used for standard market settlement.
	Exchange common.Address
	// NegRiskExchange is the CTF Exchange V2 contract used for neg-risk market settlement.
	NegRiskExchange common.Address
	// NegRiskAdapter is the adapter used for neg-risk conversion and redemption flows.
	NegRiskAdapter common.Address
	// Collateral is the pUSD collateral token used by CTF split, merge, and redeem calls.
	Collateral common.Address
	// ConditionalTokens is the Gnosis Conditional Tokens contract used by Polymarket.
	ConditionalTokens common.Address
	// UMAAdapter is the oracle address used when deriving condition IDs from question IDs.
	UMAAdapter common.Address
}

type CreateRFQQuoteRequest struct {
	// RequestID references the original RFQ request.
	RequestID string `json:"requestId"`
	// AssetIn is the ERC-20 address being sent.
	AssetIn string `json:"assetIn"`
	// AssetOut is the ERC-20 address being received.
	AssetOut string `json:"assetOut"`
	// AmountIn is the input quantity.
	AmountIn Float64 `json:"amountIn"`
	// AmountOut is the quoted output quantity.
	AmountOut Float64 `json:"amountOut"`
	// UserType identifies the signature method.
	UserType SignatureType `json:"userType"`
}

type CreateRFQRequest struct {
	// AssetIn is the ERC-20 address of the asset being sent.
	AssetIn string `json:"assetIn"`
	// AssetOut is the ERC-20 address of the asset being received.
	AssetOut string `json:"assetOut"`
	// AmountIn is the input quantity.
	AmountIn Float64 `json:"amountIn"`
	// AmountOut is the desired output quantity.
	AmountOut Float64 `json:"amountOut"`
	// UserType identifies the signature method.
	UserType SignatureType `json:"userType"`
}

type Credentials struct {
	// Key is the API key identifier.
	Key string `json:"apiKey"`
	// Secret is the HMAC secret used to sign requests.
	Secret string `json:"secret"`
	// Passphrase protects the API key secret.
	Passphrase string `json:"passphrase"`
}

type CurrentReward struct {
	// ConditionID is the market condition identifier.
	ConditionID string `json:"condition_id"`
	// RewardsConfig lists the active reward periods.
	RewardsConfig []RewardsConfig `json:"rewards_config"`
	// RewardsMaxSpread is the max spread to qualify for rewards.
	RewardsMaxSpread Float64 `json:"rewards_max_spread"`
	// RewardsMinSize is the minimum order size to qualify.
	RewardsMinSize Float64 `json:"rewards_min_size"`
}

type Date = shared.Date

type DropNotificationParams struct {
	// IDs is the list of notification identifiers to drop.
	IDs []string `url:"ids,omitempty"`
}

type Earning struct {
	// AssetAddress is the reward asset contract address.
	AssetAddress string `json:"asset_address"`
	// Earnings is the total reward amount.
	Earnings Float64 `json:"earnings"`
	// AssetRate is the reward asset exchange rate.
	AssetRate Float64 `json:"asset_rate"`
}

type EarningsParams struct {
	// Date filters by reward date.
	Date string `url:"date,omitempty"`
	// OrderBy sets the sort field.
	OrderBy string `url:"order_by,omitempty"`
	// Position sets the result offset.
	Position string `url:"position,omitempty"`
	// NoCompetition skips low-competition markets.
	NoCompetition bool `url:"no_competition,omitempty"`
	// NextCursor is the pagination cursor.
	NextCursor string `url:"next_cursor,omitempty"`
}

type FeeInfo struct {
	// Rate is the fee rate.
	Rate Float64 `json:"r"`
	// Exponent is the fee exponent.
	Exponent Float64 `json:"e"`
	// TakerOnly is true when fees apply only to takers.
	TakerOnly bool `json:"to"`
}

type FeeRateResponse struct {
	// BaseFee is the base fee in basis points.
	BaseFee Int `json:"base_fee"`
}

type Float64 = shared.Float64

type GeoblockResponse struct {
	// Blocked is true when the IP is in a restricted jurisdiction.
	Blocked bool `json:"blocked"`
	// IP is the detected client IP.
	IP string `json:"ip"`
	// Country is the ISO country code.
	Country string `json:"country"`
	// Region is the geographic region.
	Region string `json:"region"`
}

type HeartbeatResponse struct {
	// HeartbeatID is the unique heartbeat identifier.
	HeartbeatID string `json:"heartbeat_id"`
	// Error contains error details on failure.
	Error string `json:"error"`
}

type Int = shared.Int

type Int64 = shared.Int64

type LastTradePriceResponse struct {
	// Price is the trade price.
	Price Float64 `json:"price"`
	// Side is the trade direction.
	Side Side `json:"side"`
}

type LastTradesPricesResponse struct {
	// TokenID is the conditional token identifier.
	TokenID String `json:"token_id"`
	// Price is the last trade price.
	Price Float64 `json:"price"`
	// Side is the trade direction.
	Side Side `json:"side"`
}

type MakerOrder struct {
	// OrderID is the order that was filled.
	OrderID string `json:"order_id"`
	// Owner is the order owner address.
	Owner string `json:"owner"`
	// MakerAddress is the maker wallet address.
	MakerAddress string `json:"maker_address"`
	// MatchedAmount is the quantity matched.
	MatchedAmount Float64 `json:"matched_amount"`
	// Price is the fill price.
	Price Float64 `json:"price"`
	// FeeRateBps is the fee rate in basis points.
	FeeRateBps Float64 `json:"fee_rate_bps"`
	// AssetID is the conditional token identifier.
	AssetID String `json:"asset_id"`
	// Outcome is the outcome label.
	Outcome string `json:"outcome"`
	// Side is the order direction.
	Side Side `json:"side"`
}

type Market struct {
	// EnableOrderBook indicates order book functionality is available.
	EnableOrderBook bool `json:"enable_order_book"`
	// Active is true when the market is accepting trades.
	Active bool `json:"active"`
	// Closed is true when the market has closed.
	Closed bool `json:"closed"`
	// Archived is true when the market is archived.
	Archived bool `json:"archived"`
	// AcceptingOrders indicates the order book is accepting new orders.
	AcceptingOrders bool `json:"accepting_orders"`
	// AcceptingOrderTimestamp is when the market started accepting orders.
	AcceptingOrderTimestamp Time `json:"accepting_order_timestamp"`
	// MinimumOrderSize is the smallest allowed order.
	MinimumOrderSize Float64 `json:"minimum_order_size"`
	// MinimumTickSize is the price increment granularity.
	MinimumTickSize Float64 `json:"minimum_tick_size"`
	// ConditionID is the CTF condition identifier.
	ConditionID string `json:"condition_id"`
	// QuestionID identifies the underlying Polymarket question.
	QuestionID string `json:"question_id"`
	// Question is the market question text.
	Question string `json:"question"`
	// Description is the market description.
	Description string `json:"description"`
	// MarketSlug is the URL-friendly market slug.
	MarketSlug string `json:"market_slug"`
	// EndDateISO is the market resolution date.
	EndDateISO Time `json:"end_date_iso"`
	// GameStartTime is the event start time.
	GameStartTime Time `json:"game_start_time"`
	// SecondsDelay is the delay period before order book acceptance.
	SecondsDelay Uint64 `json:"seconds_delay"`
	// FPMM is the Fixed Product Market Maker address.
	FPMM string `json:"fpmm"`
	// MakerBaseFee is the maker fee rate.
	MakerBaseFee Float64 `json:"maker_base_fee"`
	// TakerBaseFee is the taker fee rate.
	TakerBaseFee Float64 `json:"taker_base_fee"`
	// NotificationsEnabled indicates push notifications are active.
	NotificationsEnabled bool `json:"notifications_enabled"`
	// NegRisk indicates a negative-risk market resolution.
	NegRisk bool `json:"neg_risk"`
	// NegRiskMarketID identifies the neg-risk grouping.
	NegRiskMarketID string `json:"neg_risk_market_id"`
	// NegRiskRequestID is the original request identifier.
	NegRiskRequestID string `json:"neg_risk_request_id"`
	// Icon is the market icon URL.
	Icon string `json:"icon"`
	// Image is the market banner image URL.
	Image string `json:"image"`
	// Rewards contains reward parameters.
	Rewards Rewards `json:"rewards"`
	// Is5050Outcome is true for binary 50/50 markets.
	Is5050Outcome bool `json:"is_50_50_outcome"`
	// Tokens lists the conditional outcome tokens.
	Tokens []Token `json:"tokens"`
	// Tags categorize the market.
	Tags []string `json:"tags"`
}

type MarketByToken struct {
	// ConditionID is the CTF condition identifier.
	ConditionID string `json:"condition_id"`
	// PrimaryTokenID is the winning outcome token ID.
	PrimaryTokenID String `json:"primary_token_id"`
	// SecondaryTokenID is the losing outcome token ID.
	SecondaryTokenID String `json:"secondary_token_id"`
}

type MarketOrderArgsV2 struct {
	// TokenID is the conditional token identifier.
	TokenID string `json:"token_id"`
	// Amount is the market order quantity.
	Amount float64 `json:"amount"`
	// Side is the order direction.
	Side Side `json:"side"`
	// Price is the slippage protection limit price.
	Price float64 `json:"price,omitempty"`
	// OrderType is the execution type.
	OrderType OrderType `json:"order_type,omitempty"`
	// UserUSDCBalance is the user's current balance.
	UserUSDCBalance float64 `json:"user_usdc_balance,omitempty"`
	// BuilderCode is the builder fee split code.
	BuilderCode string `json:"builder_code,omitempty"`
	Metadata    string `json:"metadata,omitempty"`
}

type MarketReward struct {
	// ConditionID is the market condition identifier.
	ConditionID string `json:"condition_id"`
	// Question is the market question text.
	Question string `json:"question"`
	// MarketSlug is the URL-friendly market slug.
	MarketSlug string `json:"market_slug"`
	// EventSlug is the parent event slug.
	EventSlug string `json:"event_slug"`
	// Image is the market banner image URL.
	Image string `json:"image"`
	// RewardsMaxSpread is the max spread to qualify.
	RewardsMaxSpread Float64 `json:"rewards_max_spread"`
	// RewardsMinSize is the minimum order size to qualify.
	RewardsMinSize Float64 `json:"rewards_min_size"`
	// MarketCompetitiveness indicates market saturation.
	MarketCompetitiveness Float64 `json:"market_competitiveness"`
	// Tokens lists the conditional outcome tokens.
	Tokens []Token `json:"tokens"`
	// RewardsConfig lists the active reward periods.
	RewardsConfig []MarketRewardsConfig `json:"rewards_config"`
}

type MarketRewardsConfig struct {
	// ID is the config identifier.
	ID String `json:"id"`
	// AssetAddress is the reward asset contract address.
	AssetAddress string `json:"asset_address"`
	// StartDate is the reward start date.
	StartDate Date `json:"start_date"`
	// EndDate is the reward end date.
	EndDate Date `json:"end_date"`
	// RatePerDay is the daily reward rate.
	RatePerDay Float64 `json:"rate_per_day"`
	// TotalRewards is the total reward pool.
	TotalRewards Float64 `json:"total_rewards"`
	// TotalDays is the duration in days.
	TotalDays Float64 `json:"total_days"`
}

type MergePositionsRequest struct {
	// CollateralToken is the pUSD token address received after merging a full set.
	CollateralToken common.Address
	// ParentCollectionID is zero for top-level Polymarket markets.
	ParentCollectionID common.Hash
	// ConditionID is the market condition ID.
	ConditionID common.Hash
	// Partition is the list of index sets to burn; binary markets use [1, 2].
	Partition []*big.Int
	// Amount is the number of full outcome sets to merge, in base units.
	Amount *big.Int
}

type MidpointResponse struct {
	// Mid is the midpoint between best bid and best ask.
	Mid Float64 `json:"mid"`
}

type NegRiskResponse struct {
	// NegRisk is true for neg-risk markets.
	NegRisk bool `json:"neg_risk"`
}

type Notification struct {
	// Type identifies the notification category.
	Type Int `json:"type"`
	// Owner is the recipient address.
	Owner string `json:"owner"`
	// Payload contains the notification data.
	Payload jsonRawObject `json:"payload"`
}

type OpenOrder struct {
	// ID is the order identifier.
	ID string `json:"id"`
	// Status is the current order status.
	Status string `json:"status"`
	// Owner is the order owner address.
	Owner string `json:"owner"`
	// MakerAddress is the maker wallet address.
	MakerAddress string `json:"maker_address"`
	// Market is the condition ID the order belongs to.
	Market string `json:"market"`
	// AssetID is the conditional token identifier.
	AssetID String `json:"asset_id"`
	// Side is the order direction.
	Side Side `json:"side"`
	// OriginalSize is the initial order quantity.
	OriginalSize Float64 `json:"original_size"`
	// SizeMatched is the quantity already filled.
	SizeMatched Float64 `json:"size_matched"`
	// Price is the limit price.
	Price Float64 `json:"price"`
	// AssociateTrades lists the trade IDs from fills.
	AssociateTrades []string `json:"associate_trades"`
	// Outcome is the outcome label.
	Outcome string `json:"outcome"`
	// CreatedAt is when the order was placed.
	CreatedAt Time `json:"created_at"`
	// Expiration is the order expiry time.
	Expiration Time `json:"expiration"`
	// OrderType is the execution type.
	OrderType OrderType `json:"order_type"`
}

type OpenOrderParams struct {
	// ID filters by order identifier.
	ID string `url:"id,omitempty"`
	// Market filters by condition ID.
	Market string `url:"market,omitempty"`
	// AssetID filters by conditional token identifier.
	AssetID string `url:"asset_id,omitempty"`
}

type Option func(*Client)

type OrderArgsV2 struct {
	// TokenID is the conditional token identifier.
	TokenID string `json:"token_id"`
	// Price is the limit price.
	Price float64 `json:"price"`
	// Size is the order quantity.
	Size float64 `json:"size"`
	// Side is the order direction.
	Side Side `json:"side"`
	// Expiration is the order expiry Unix timestamp (0 = GTC).
	Expiration int64 `json:"expiration,omitempty"`
	// BuilderCode is the builder fee split code.
	BuilderCode string `json:"builder_code,omitempty"`
	// Metadata is optional caller-provided metadata.
	Metadata string `json:"metadata,omitempty"`
}

type OrderBookSummary struct {
	// Market is the condition ID.
	Market string `json:"market"`
	// AssetID is the token ID.
	AssetID String `json:"asset_id"`
	// Timestamp is when the snapshot was taken.
	Timestamp Time `json:"timestamp"`
	// Bids are buy orders sorted best-first.
	Bids []OrderSummary `json:"bids"`
	// Asks are sell orders sorted best-first.
	Asks []OrderSummary `json:"asks"`
	// MinOrderSize is the minimum order quantity.
	MinOrderSize Float64 `json:"min_order_size"`
	// NegRisk indicates a negative-risk market.
	NegRisk bool `json:"neg_risk"`
	// TickSize is the minimum price increment.
	TickSize Float64 `json:"tick_size"`
	// LastTradePrice is the price of the most recent trade.
	LastTradePrice Float64 `json:"last_trade_price"`
	// Hash is the order book snapshot hash.
	Hash string `json:"hash"`
}

type OrderMarketCancelParams struct {
	// Market is the condition ID to cancel orders for.
	Market string `json:"market,omitempty"`
	// AssetID is the conditional token to cancel.
	AssetID string `json:"asset_id,omitempty"`
}

type OrderScoring struct {
	// Scoring is true when the order is in the scoring queue.
	Scoring bool `json:"scoring"`
}

type OrderSummary struct {
	// Price is the limit order price.
	Price Float64 `json:"price"`
	// Size is the available quantity at this price.
	Size Float64 `json:"size"`
}

type OrderType string

type Page[T any] struct {
	// Limit is the requested page size.
	Limit Int `json:"limit"`
	// Count is the number of results on this page.
	Count Int `json:"count"`
	// NextCursor is the pagination cursor for the next page, empty when exhausted.
	NextCursor string `json:"next_cursor"`
	// Data contains the page results.
	Data []T `json:"data"`
}

type PostOrderRequest struct {
	// Order is the signed order payload.
	Order SignedOrder `json:"order"`
	// Owner is the order owner address.
	Owner string `json:"owner"`
	// OrderType is the execution type (GTC, FOK, GTD).
	OrderType OrderType `json:"orderType"`
}

type PostOrderResponse struct {
	// Success is true when the order was accepted.
	Success bool `json:"success"`
	// ErrorMsg contains the error description on failure.
	ErrorMsg string `json:"errorMsg"`
	// OrderID is the assigned order identifier.
	OrderID string `json:"orderID"`
	// TransactionHashes lists on-chain transaction hashes.
	TransactionHashes []string `json:"transactionsHashes"`
	// Status is the order processing status.
	Status string `json:"status"`
	// TakingAmount is the amount filled from the order.
	TakingAmount Float64 `json:"takingAmount"`
	// MakingAmount is the remaining order amount.
	MakingAmount Float64 `json:"makingAmount"`
	// TradeIDs lists the resulting trade identifiers.
	TradeIDs []string `json:"trade_ids"`
}

type PriceHistoryParams struct {
	// Market is the condition ID.
	Market string `url:"market,omitempty"`
	// StartTS is the start Unix timestamp.
	StartTS int64 `url:"startTs,omitempty"`
	// EndTS is the end Unix timestamp.
	EndTS int64 `url:"endTs,omitempty"`
	// Fidelity controls the data point density.
	Fidelity int `url:"fidelity,omitempty"`
	// Interval sets the bucket size (e.g. "5m", "1h").
	Interval string `url:"interval,omitempty"`
}

type PriceHistoryResponse struct {
	// History is the ordered list of price points.
	History []PricePoint `json:"history"`
}

type PricePoint struct {
	// T is the Unix timestamp.
	T Int64 `json:"t"`
	// P is the price at time T.
	P Float64 `json:"p"`
}

type PriceResponse struct {
	// Price is the current price.
	Price Float64 `json:"price"`
}

type RFQListParams struct {
	// Offset is the start index.
	Offset string `url:"offset,omitempty"`
	// Limit sets the maximum returned results.
	Limit int `url:"limit,omitempty"`
	// State filters by quote/request state.
	State string `url:"state,omitempty"`
	// RequestIDs filters by request IDs.
	RequestIDs []string `url:"requestIds,omitempty"`
	// QuoteIDs filters by quote IDs.
	QuoteIDs []string `url:"quoteIds,omitempty"`
	// Markets filters by condition IDs.
	Markets []string `url:"markets,omitempty"`
	// SizeMin filters by minimum trade size.
	SizeMin Float64 `url:"sizeMin,omitempty"`
	// SizeMax filters by maximum trade size.
	SizeMax Float64 `url:"sizeMax,omitempty"`
	// SizeUSDCMin filters by minimum USDC value.
	SizeUSDCMin Float64 `url:"sizeUsdcMin,omitempty"`
	// SizeUSDCMax filters by maximum USDC value.
	SizeUSDCMax Float64 `url:"sizeUsdcMax,omitempty"`
	// PriceMin filters by minimum price.
	PriceMin Float64 `url:"priceMin,omitempty"`
	// PriceMax filters by maximum price.
	PriceMax Float64 `url:"priceMax,omitempty"`
	// SortBy sets the sort field.
	SortBy string `url:"sortBy,omitempty"`
	// SortDir sets the sort direction (asc/desc).
	SortDir string `url:"sortDir,omitempty"`
}

type ReadonlyAPIKey struct {
	// APIKey is the read-only key value.
	APIKey string `json:"apiKey"`
}

type Rebate struct {
	// Date is the rebate date.
	Date Date `json:"date"`
	// ConditionID is the market condition identifier.
	ConditionID string `json:"condition_id"`
	// AssetAddress is the reward asset contract address.
	AssetAddress string `json:"asset_address"`
	// MakerAddress is the maker wallet address.
	MakerAddress string `json:"maker_address"`
	// RebatedFeesUSDC is the total rebated fee in USDC.
	RebatedFeesUSDC Float64 `json:"rebated_fees_usdc"`
}

type RebateParams struct {
	// Date filters by reward date.
	Date string `url:"date,omitempty"`
	// MakerAddress filters by maker wallet address.
	MakerAddress string `url:"maker_address,omitempty"`
}

type RedeemNegRiskRequest struct {
	// ConditionID is the resolved neg-risk condition ID.
	ConditionID common.Hash
	// Amounts contains the per-index-set amounts expected by the neg-risk adapter.
	Amounts []*big.Int
}

type RedeemPositionsRequest struct {
	// CollateralToken is the pUSD token address redeemed after market resolution.
	CollateralToken common.Address
	// ParentCollectionID is zero for top-level Polymarket markets.
	ParentCollectionID common.Hash
	// ConditionID is the resolved market condition ID.
	ConditionID common.Hash
	// IndexSets are the outcome index sets to redeem; binary markets use [1, 2].
	IndexSets []*big.Int
}

type RelayerCTFRequest struct {
	// From is the signer address.
	From string
	// ProxyWallet is the user's Polymarket proxy wallet.
	ProxyWallet string
	// Nonce is the relayer transaction nonce.
	Nonce string
	// Signature is the 0x-prefixed Safe or proxy transaction signature.
	Signature string
	// SignatureParams are Safe transaction parameters.
	SignatureParams relayer.SignatureParams
	// Type is the relayer transaction type, typically SAFE or PROXY.
	Type string
	// Metadata is optional caller-provided transaction metadata.
	Metadata string
	// Value is the native token value for the call when required.
	Value string
}

type RelayerSubmitter interface {
	SubmitTransaction(context.Context, relayer.SubmitTransactionRequest, *relayer.SubmitTransactionResponse) error
}

type RewardRate struct {
	// AssetAddress is the reward asset contract address.
	AssetAddress string `json:"asset_address"`
	// RewardsDailyRate is the daily reward amount.
	RewardsDailyRate Float64 `json:"rewards_daily_rate"`
}

type Rewards struct {
	// Rates is the list of asset-specific reward rates.
	Rates []RewardRate `json:"rates"`
	// MinSize is the minimum order size to qualify for rewards.
	MinSize Float64 `json:"min_size"`
	// MaxSpread is the maximum bid-ask spread to qualify for rewards.
	MaxSpread Float64 `json:"max_spread"`
}

type RewardsConfig struct {
	AssetAddress string  `json:"asset_address"`
	StartDate    Date    `json:"start_date"`
	EndDate      Date    `json:"end_date"`
	RatePerDay   Float64 `json:"rate_per_day"`
	TotalRewards Float64 `json:"total_rewards"`
}

type RewardsMarketsParams struct {
	// ConditionID filters by market ID.
	ConditionID string `url:"condition_id,omitempty"`
	// Date filters by reward date.
	Date string `url:"date,omitempty"`
	// NextCursor is the pagination cursor.
	NextCursor string `url:"next_cursor,omitempty"`
}

type RfqQuote struct {
	// QuoteID is the unique quote identifier.
	QuoteID string `json:"quoteId"`
	// RequestID references the original RFQ request.
	RequestID string `json:"requestId"`
	// UserAddress is the requester wallet address.
	UserAddress string `json:"userAddress"`
	// ProxyAddress is the proxy wallet address.
	ProxyAddress string `json:"proxyAddress"`
	// Condition is the condition the quote applies to.
	Condition string `json:"condition"`
	// Token is the asset being offered.
	Token String `json:"token"`
	// Complement is the complementary asset.
	Complement String `json:"complement"`
	// Side is the trade direction.
	Side Side `json:"side"`
	// SizeIn is the input quantity.
	SizeIn Float64 `json:"sizeIn"`
	// SizeOut is the output quantity.
	SizeOut Float64 `json:"sizeOut"`
	// Price is the quoted price.
	Price Float64 `json:"price"`
}

type RfqRequest struct {
	// RequestID is the unique request identifier.
	RequestID string `json:"requestId"`
	// UserAddress is the requester wallet address.
	UserAddress string `json:"userAddress"`
	// ProxyAddress is the proxy wallet address.
	ProxyAddress string `json:"proxyAddress"`
	// Condition is the condition the request applies to.
	Condition string `json:"condition"`
	// Token is the asset being offered.
	Token String `json:"token"`
	// Complement is the complementary asset.
	Complement String `json:"complement"`
	// Side is the requested trade direction.
	Side Side `json:"side"`
	// SizeIn is the input quantity.
	SizeIn Float64 `json:"sizeIn"`
	// SizeOut is the output quantity.
	SizeOut Float64 `json:"sizeOut"`
	// Price is the requested price.
	Price Float64 `json:"price"`
	// Expiry is the request expiry Unix timestamp.
	Expiry Int64 `json:"expiry"`
}

type Side string

type SignatureType int

type SignedOrder struct {
	// Salt is the order uniqueness salt.
	Salt String `json:"salt"`
	// Maker is the order creator address.
	Maker string `json:"maker"`
	// Signer is the signing authority address.
	Signer string `json:"signer"`
	// Taker is the order taker address (empty for any).
	Taker string `json:"taker,omitempty"`
	// TokenID is the conditional token identifier.
	TokenID String `json:"tokenId"`
	// MakerAmount is the amount the maker offers.
	MakerAmount String `json:"makerAmount"`
	// TakerAmount is the amount the maker wants.
	TakerAmount String `json:"takerAmount"`
	// Expiration is the order expiry timestamp.
	Expiration String `json:"expiration,omitempty"`
	// Nonce is the order nonce.
	Nonce String `json:"nonce,omitempty"`
	// FeeRateBps is the fee rate in basis points.
	FeeRateBps String `json:"feeRateBps,omitempty"`
	// Side is the order direction.
	Side Side `json:"side"`
	// SignatureType identifies the signature method.
	SignatureType SignatureType `json:"signatureType"`
	// Timestamp is when the order was created.
	Timestamp String `json:"timestamp"`
	// Metadata is optional order metadata.
	Metadata string `json:"metadata"`
	// Builder is the builder code for fee splits.
	Builder string `json:"builder"`
	// Signature is the EIP-712 signature bytes.
	Signature string `json:"signature"`
}

type SimplifiedMarket struct {
	// ConditionID is the CTF condition identifier.
	ConditionID string `json:"condition_id"`
	// Tokens lists the conditional outcome tokens.
	Tokens []Token `json:"tokens"`
	// Rewards contains reward parameters.
	Rewards Rewards `json:"rewards"`
	// Active is true when the market is accepting trades.
	Active bool `json:"active"`
	// Closed is true when the market has closed.
	Closed bool `json:"closed"`
	// Archived is true when the market is archived.
	Archived bool `json:"archived"`
	// AcceptingOrders indicates the order book is accepting new orders.
	AcceptingOrders bool `json:"accepting_orders"`
}

type SplitPositionRequest struct {
	// CollateralToken is the pUSD token address supplied as collateral.
	CollateralToken common.Address
	// ParentCollectionID is zero for top-level Polymarket markets.
	ParentCollectionID common.Hash
	// ConditionID is the market condition ID.
	ConditionID common.Hash
	// Partition is the list of index sets to mint; binary markets use [1, 2].
	Partition []*big.Int
	// Amount is the pUSD amount, in base units, to split into a full outcome set.
	Amount *big.Int
}

type SpreadResponse struct {
	// Spread is the difference between best ask and best bid.
	Spread Float64 `json:"spread"`
}

type String = shared.String

type TickSize string

type TickSizeResponse struct {
	// MinimumTickSize is the minimum price increment.
	MinimumTickSize TickSize `json:"minimum_tick_size"`
}

type Time = shared.Time

type Token struct {
	// TokenID is the ERC-1155 token identifier.
	TokenID String `json:"token_id"`
	// Outcome is the outcome label (e.g. "Yes", "No").
	Outcome string `json:"outcome"`
	// Price is the current market price.
	Price Float64 `json:"price"`
	// Winner is true when this outcome has been resolved as correct.
	Winner bool `json:"winner,omitempty"`
}

type Trade struct {
	// ID is the trade identifier.
	ID string `json:"id"`
	// TakerOrderID is the taker's order ID.
	TakerOrderID string `json:"taker_order_id"`
	// Market is the condition ID.
	Market string `json:"market"`
	// AssetID is the conditional token identifier.
	AssetID String `json:"asset_id"`
	// Side is the trade direction.
	Side Side `json:"side"`
	// Size is the matched quantity.
	Size Float64 `json:"size"`
	// FeeRateBps is the fee rate in basis points.
	FeeRateBps Float64 `json:"fee_rate_bps"`
	// Price is the execution price.
	Price Float64 `json:"price"`
	// Status is the trade processing status.
	Status string `json:"status"`
	// MatchTime is when the trade was matched.
	MatchTime Time `json:"match_time"`
	// LastUpdate is the last status change.
	LastUpdate Time `json:"last_update"`
	// Outcome is the outcome label.
	Outcome string `json:"outcome"`
	// BucketIndex is the price bucket index.
	BucketIndex Int `json:"bucket_index"`
	// Owner is the trade owner address.
	Owner string `json:"owner"`
	// MakerAddress is the maker wallet address.
	MakerAddress string `json:"maker_address"`
	// MakerOrders lists the maker orders that were filled.
	MakerOrders []MakerOrder `json:"maker_orders"`
	// TransactionHash is the on-chain transaction hash.
	TransactionHash string `json:"transaction_hash"`
	// TraderSide identifies taker or maker role.
	TraderSide string `json:"trader_side"`
	// ErrorMsg contains error details on failure.
	ErrorMsg string `json:"error_msg"`
}

type TradeParams struct {
	// ID filters by trade identifier.
	ID string `url:"id,omitempty"`
	// TakerAddress filters by taker wallet address.
	TakerAddress string `url:"taker,omitempty"`
	// MakerAddress filters by maker wallet address.
	MakerAddress string `url:"maker,omitempty"`
	// Market filters by condition ID.
	Market string `url:"market,omitempty"`
	// AssetID filters by conditional token identifier.
	AssetID string `url:"asset_id,omitempty"`
	// Before filters trades before this Unix timestamp.
	Before int64 `url:"before,omitempty"`
	// After filters trades after this Unix timestamp.
	After int64 `url:"after,omitempty"`
}

type TxReceipt struct {
	// Hash is the transaction hash.
	Hash common.Hash
	// BlockNumber is the block that included the transaction.
	BlockNumber uint64
}

type Uint64 = shared.Uint64

type UserEarning struct {
	// Date is the earning date.
	Date Date `json:"date"`
	// ConditionID is the market condition identifier.
	ConditionID string `json:"condition_id"`
	// AssetAddress is the reward asset contract address.
	AssetAddress string `json:"asset_address"`
	// MakerAddress is the maker wallet address.
	MakerAddress string `json:"maker_address"`
	// Earnings is the total reward earned in USDC.
	Earnings Float64 `json:"earnings"`
	// AssetRate is the reward asset exchange rate.
	AssetRate Float64 `json:"asset_rate"`
}

type UserRewardsEarning struct {
	ConditionID           string          `json:"condition_id"`
	Question              string          `json:"question"`
	MarketSlug            string          `json:"market_slug"`
	EventSlug             string          `json:"event_slug"`
	Image                 string          `json:"image"`
	RewardsMaxSpread      Float64         `json:"rewards_max_spread"`
	RewardsMinSize        Float64         `json:"rewards_min_size"`
	MarketCompetitiveness Float64         `json:"market_competitiveness"`
	Tokens                []Token         `json:"tokens"`
	RewardsConfig         []RewardsConfig `json:"rewards_config"`
	MakerAddress          string          `json:"maker_address"`
	EarningPercentage     Float64         `json:"earning_percentage"`
	Earnings              []Earning       `json:"earnings"`
}

type WSAuth struct {
	// APIKey is the WebSocket API key.
	APIKey string `json:"apiKey"`
	// Secret is the WebSocket HMAC secret.
	Secret string `json:"secret"`
	// Passphrase protects the WebSocket API key.
	Passphrase string `json:"passphrase"`
}