ConsumerV1

List public markets

get/markets

Request

  • Base URL: https://kellian.app/api/v1
  • URL: https://kellian.app/api/v1/markets
  • Auth: none required

Query parameters

marketState'open' | 'closed' | 'creator_proposal' | 'challenge' | 'human_voting' | 'council_review' | 'resolved' | 'void'

Canonical market state shared by every protocol surface.

categorystring
sortstring
dateRangestring
endsBeforestring date-time
creatorstring
string
OR
number
cursorstring
string
OR
number
collateralstring
pricingModelstring
searchstring
match'closest'
string
OR
number
string
OR
number
electionRegion'US' | 'CA' | 'WORLD'
electionPlacestring
electionOffice'senate' | 'house' | 'governor' | 'legislature' | 'provincial_legislature' | 'mayor' | 'president' | 'referendum' | 'council'
geoPlacestring
geoCountrystring

Response

Success

marketIdinteger required
addressstring required
chainIdinteger required

Compiled protocol release chain ID (Base 8453).

questionstring required
settlement'onchain' | 'committed'

Which engine settles this market's fills. onchain = the market contract holds collateral and outcome tokens, and every fill is its own Base transaction. committed = the venue's commit ledger holds them, a fill is paid the instant it matches, and fills are published to Base in batches as standard ERC-1155 transfers under a chained Merkle root — so a trade is recorded on Base a short time after it happens rather than at the moment it happens. Immutable per market, decided by the market's collateral.

categorystring required
marketTypestring required
pricingModelstring nullable
resolutionTimestring required
endTimestring required
marketState'open' | 'closed' | 'creator_proposal' | 'challenge' | 'human_voting' | 'council_review' | 'resolved' | 'void' required

Canonical market state shared by every protocol surface.

outcomeinteger nullable required
totalVolumestring nullable required
volume24hstring nullable required
imageUrlstring nullable required
marketDatestring nullable required
createdAtstring nullable required
closeTimestring nullable required
outcome1Labelstring nullable required
outcome2Labelstring nullable required
outcome3Labelstring nullable required
resolutionCriteriastring nullable required
descriptionstring nullable required
collateralTokenstring nullable required
collateralSymbolstring nullable required
createdBystring nullable required
isPermissionlessboolean required
creatorTierstring nullable required
creatorScorenumber nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.