Skip to main content

Five-Minute Quickstart

This walkthrough takes you through your first prediction trade. All you need is a Solana wallet and some USDC (plus ~0.01 SOL for fees and rent).

0. Prerequisites

  • Install a Solana browser wallet (Phantom, Solflare, Backpack, …).
  • Get USDC:
    • Mainnet: official USDC (EPjFWdd5…TDt1v);
    • Devnet: test USDC for a free trial run.
  • A little SOL for transaction fees.

1. Connect a Wallet

Open the Astromarkets web app, click Connect Wallet in the top-right corner, pick your wallet and approve the connection. Once connected, the navbar shows your address and USDC balance.

2. Pick a Market

The home page is the market list, filterable by category (Politics / Sports / Crypto / Finance …). Each card shows:

  • the market question and category;
  • a status badge (tradable markets are Active);
  • an expiry countdown;
  • the creator and their security deposit.

Click a card to open the trading page. Pick a market that is Active and not yet expired.

3. Read the Trading Page

The top of the page shows the question and the current Yes / No probability bar (derived from the book's best bid/ask). Below it:

  • Info / Rules / Oracle card: market addresses, resolution rules, oracle feed (view the feed JSON, simulate its value);
  • Order Book: live depth merging YES and NO cross-side liquidity;
  • My Holdings / My Orders: your positions and open orders;
  • the Order Panel on the right.

4. Place Your First Order

In the order panel on the right:

  1. Select Buy.
  2. Pick a side, Yes or No — the buttons show live prices.
  3. Choose the order type:
    • Market: fill immediately at the current opposing price (requires resting orders on that side);
    • Limit: set your own price (0.1–99.9 "cents", i.e. 0.001–0.999 USDC) and wait to be filled.
  4. Enter the quantity (Shareholding), or use the quick buttons 10 / 25 / 50 / 100.
  5. Review the summary: subtotal, 0.2% taker fee, total cost, max profit.
  6. Click Buy Yes/No · $x.xx and sign in your wallet.
Your first trade bundles a few extra instructions

The first order automatically prepends instructions that create your TraderInfo account and your USDC / YES / NO token accounts — one signature does it all, no manual setup.

After confirmation a Tx Confirmed toast appears with a View on Explorer link.

The settlement data source is configured by the market creator — the platform does not vouch for any feed's correctness

Before trading, always audit the data source yourself via the Oracle tab:

  • does the task-graph logic actually match the market title

  • is the data source (API/website) reliable

  • does the Simulate result match expectations

Do not trade on data sources that look suspicious or that you cannot understand!

5. What Happens Next

  • Unfilled limit order: rests on the book; cancel any time in My Orders;
  • After a fill: positions show up in My Holdings; maker proceeds must be withdrawn with Claim Funds;
  • After expiry: the oracle resolves, the dispute window passes, and the market settles — if you hold winning tokens, claim USDC in the Settlement panel.

Every step is covered in the User Guide.

Want a Free Devnet Run?

The frontend selects the network by Vite mode: the devnet build connects to the devnet program (7zBQywPg…H7EJ8) where all time windows shrink to minutes — ideal for a full "create → trade → resolve → dispute → settle" cycle.