Docs

Conviction Markets

A prediction market discovery and margin layer. Browse real event markets, review the rules, request margin, and build your reputation onchain.
Protocol guide

The .viction Community

Every trader on Conviction Markets has a handle ending in .viction — like alex.viction, sarah.viction, or griffins.viction. It's our family name. A badge of belonging.

The .viction suffix comes from conviction — the principle that the best trades come from deeply held beliefs backed by real analysis. When you see a .viction handle, you know you're looking at a member of a community that values thesis-driven trading over noise.

Pro tip: Set your handle to something memorable. Your .viction identity is your reputation on the platform.

Platform Overview

Conviction Markets connects traders to prediction market data through a margin desk. The platform is built around three core concepts:

  • Signals — Public trade theses that express your conviction in a market outcome. Signals are separate from execution; they're ideas, not orders.
  • Margin Intents — Leveraged position requests that borrow capital from vaults to amplify exposure. Intents are recorded onchain through a three-step wallet flow.
  • Copy Trading — Follow a trader's position by submitting a copy intent. Your copy mirrors their market, side, and size.

All data comes from the Conviction Core API — no fake markets, no simulated PnL, no placeholder records. If core isn't available, the app shows empty states rather than fabricated data.

Margin Leverage

The margin desk follows a prime-broker model for prediction markets:

  1. Choose a market — Select from synced prediction markets (currently Polymarket data via the Gamma API).
  2. Set collateral — Deposit USDC or WETH as your margin.
  3. Select leverage — Multiply your exposure up to the platform maximum (configurable per chain).
  4. Submit intent — Record your margin position on the core API. This creates a PENDING_EXECUTION position intent.
Important: Margin execution requires deployed vault contracts, active execution adapters, and onchain liquidity. Until those are live, margin requests remain as intent records only.

How Leverage Works

When you enter a leveraged position, the vault borrows additional capital from the pool to increase your position size. For example:

  • Collateral: 1,000 USDC
  • Leverage: 5x
  • Position size: 5,000 USDC (1,000 of your capital + 4,000 borrowed)
  • Liquidation guard: If the position value drops to 82% of entry, the system triggers partial settlement to protect the vault.

The liquidation guard is an automated protection mechanism. It does not mean you will always be protected at exactly 82% — actual liquidation depends on market conditions and adapter implementation.

Trade Signals

A signal is a public trade thesis — your reasoned take on what a market will resolve to. Signals are the social layer of Conviction Markets:

  • Side: YES or NO — your predicted outcome.
  • Thesis: Your reasoning, up to 5,000 characters.
  • Conviction level: 1–100 — how confident you are.
  • Source: FARCASTER, TELEGRAM, or WEB.

Signals are not trade executions. Creating a signal does not create a position, calculate PnL, or imply a fill. Signals are ideas that build your reputation as a trader.

Other users can reply, react (like),bookmark, and copy your signals. The social feed displays all published signals in chronological order.

Copy Trading

Copy trading lets you mirror another trader's position. When you submit a copy intent:

  • You specify the source position and the quantity you want to copy.
  • The intent is recorded as PENDING_EXECUTION.
  • When execution adapters are live, the copy will be executed automatically.

Copy intents are linked to the source trader's position. The leaderboard tracks how many copies a trader has received, giving signal to the community about whose thesis has the most conviction.

Vault System

Conviction Markets uses a collateral vault system deployed on testnet chains (Base Sepolia, Ethereum Sepolia, Arbitrum Sepolia). The vault is an ERC20-based contract that:

  • Holds collateral — USDC deposited by users and pool LPs.
  • Records margin intents — Locks collateral while a margin position is active.
  • Supports authorized operators — Future execution adapters will interact with the vault for settlement.
  • Supports pause controls — Owner can pause activity during upgrades or emergencies.

The vault does not currently execute trades. It holds collateral and records intent state. Real execution requires adapter confirmation, venue connectivity, and onchain evidence.

Supported Chains

ChainVault AddressCollateral
Base Sepolia0xfeBCb5...494E3USDC
Ethereum Sepolia0xB1dA85...29f605USDC
Arbitrum Sepolia0xd53cec...A0858cUSDC

Wallet Flow

The vault transaction flow is a three-step wallet sequence:

  1. Approve USDC — Authorize the vault contract to spend your USDC collateral.
  2. Deposit Collateral — Transfer USDC into the vault.
  3. Create Margin Intent — Submit the onchain margin intent with your chosen leverage and slippage parameters.

Each step uses viem to prepare the contract call and sends it through your connected browser wallet, such as MetaMask or Coinbase Wallet.

Note: Submitting vault transactions does not guarantee a market fill, executed position, or PnL. It only records the onchain intent.

Profile & Identity

Your profile is how the community knows you. Every trader has:

  • Handle — Your unique .viction identifier (e.g., alex.viction).
  • Avatar — Your profile picture. Pick a generated Web3 avatar card, upload your own image, or set a custom image URL.
  • Bio — A short description of who you are and what you trade.
  • Email — Optional. Used for notifications about your positions and platform updates.

Visit your profile to customize your identity. Your handle, avatar, and bio appear on every signal and post you publish.

Glossary

Collateral
The USDC or WETH you deposit as security for a leveraged position.
Conviction
A measure (1–100) of how confident you are in your market thesis.
Copy Intent
A request to mirror another trader's position, pending execution.
Execution Adapter
A smart contract or service that executes trades on a venue.
Intent
A recorded request that has not been executed yet.
Leverage
A multiplier that amplifies your position size using borrowed capital.
Liquidation Guard
An automatic safety mechanism that closes a position to protect the vault.
Margin Desk
The trading interface where you submit leveraged position intents.
Signal
A public trade thesis — your reasoned prediction about a market outcome.
.viction
The community suffix for all trader handles. A badge of belonging.
Markets0
Contract StatusConfigured
Execution ModeRequest