Quote Preview

Understand current Polymarket cost, liquidity, fees, and risk without creating an executable order.

Inputs

  • Polymarket slug, URL, or canonical instrument key.
  • BUY or SELL; YES or NO.
  • BUY by maximum cash or shares; SELL by shares.
  • Automatic, aggressive, or passive route.
  • Optional saved Signal and manually entered capital.

Result

The service resolves the actual selected outcome token and reads its public order book and public fee metadata. It separates requested, fillable, and safety-capped size and reports bid/ask, depth, average and worst price, slippage, fee, cost/proceeds, payout/downside, break-even probability, Signal edge, risks, observation time, and expiry.

Status is READY, PARTIAL, PASSIVE_ONLY, SKIP, or UNAVAILABLE. Missing fee data does not produce a false exact all-in price. Passive previews never promise a fill.

Saved previews

Normal refreshes are ephemeral. Explicit save refreshes public data and stores an owner-scoped snapshot. Manual portfolio capital is not stored.

No execution

Every response contains execution: { supported: false, reason: "preview_only" }. Hedge Layer does not access inventory, cost basis, balances, credentials, signatures, or order submission. Use the external source-market link if you independently decide to act.

CLI

hl quote example-market --action buy --outcome yes --cash 25
hl quote example-market --action sell --outcome no --shares 20 --save
hl --json quote example-market --action buy --outcome yes --cash 25

See the API Reference for the wire shape.