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.
- Mainnet: official USDC (
- 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:
- Select Buy.
- Pick a side, Yes or No — the buttons show live prices.
- 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.
- Enter the quantity (Shareholding), or use the quick buttons 10 / 25 / 50 / 100.
- Review the summary: subtotal, 0.2% taker fee, total cost, max profit.
- Click Buy Yes/No · $x.xx and sign in your wallet.
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.
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
Simulateresult 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.