Create a market

You are publishing a question on chain. For example: “Will ETH be above $5,000 at year end?” with Yes and No. You get a market address back. Pictures, copy, and the first liquidity can go in the same flow. If you skip the first deposit, the market exists but nobody can trade yet. There is no separate listing step. If you pass metadata with copy or images, the client uploads the files and sets the metadata URI. Empty metadata is skipped. If you pass a deposit and an opening mix, create and seed run on the factory in one flow (approve the factory). Omit the deposit for create-only. You need a client that can send and a wallet with gas. Admin markets need an admin. Committee markets need voters and a threshold. Images can be a file, a blob, or a public URL.

const { marketAddress, metadataUri } = await client.createMarket({
  marketName: 'Will ETH be above 5k?',
  outcomes: ['Yes', 'No'],
  resolverKind: 'admin',
  marketAdmin: yourAddress,
  seedWei,           // omit for create-only
  oddsBps,           // required with seedWei
  metadata: {
    description: '…',
    resolutionCriteria: 'Coinbase ETH-USD at 23:59 UTC.',
    image: marketImageFile,
    outcomeImages: [yesFile, noFile],
  },
})

if (!marketAddress) {
  throw new Error('Created, but the receipt did not include the new address')
}

const market = client.market(marketAddress)

Promise<{
  result: unknown
  hashes: Hash[]
  marketAddress?: Address
  metadataUri?: string
}>

If metadata is present but the new address cannot be parsed from the receipt, it throws instead of leaving a silent unpublished market. Skip metadata if you have nothing to publish. Once the market is live, treat that document as frozen in the product UI. market.setMetadata still exists for a retry if the upload failed after create. This is the one write that must live on the client — there is no market handle yet.

Seed a market — skip if you already passed the first deposit
Quote a trade

Get started

How it works

Market

User

Outcome

React

Helpers

Next

​Next

Next