Paper Trading
Purpose
Section titled “Purpose”Paper Trading is the public Amoy environment for practicing and testing Arenaton flows with no real value.
| Area | Paper |
|---|---|
| Chain | Polygon Amoy (80002) |
| Collateral | PaperUSDC |
| CTF | Gnosis CTF on Amoy |
| App | https://paper.arenaton.com |
| API | https://server.arenaton.com/api/paper/* |
| Faucet | POST /api/paper/faucet/claim |
| Registry | /api/paper/contract-registry |
Paper Trading mirrors the production exchange shape without production funds. It uses the same order fields, Live State Version stale-order protection, lifecycle states, settlement semantics, and direct redemption model, but every money-like surface is separated from production.
Market Types
Section titled “Market Types”Paper markets come in three varieties:
| Type | Description | Data Source |
|---|---|---|
| Crypto Templates | Built-in price markets (BTC, ETH, SOL) | On-chain prices |
| Custom Markets | User-created prediction markets | User-defined |
| CTF Mirror Markets | Real CTF markets mirrored for paper | Polymarket CLOB API |
For the contract and indexer mechanics, read CTF Paper Mode.
Faucet Rules
Section titled “Faucet Rules”- PaperUSDC is not real USDC.
- Faucet claims are rate-limited.
- Faucet mints must never target production collateral.
- Paper balances must not appear in production portfolios.
- Claims are idempotent when the same
Idempotency-Keyis replayed. - The faucet recipient is the selected Smart Account or Raw EOA Mode account, not an Arenaton-held balance.
Paper Market Flow
Section titled “Paper Market Flow”claim PaperUSDCopen paper Marketsign EIP-712 ordermatch into matchedPending fillrun settlementshow confirmed Outcome Sharesclose Marketresolve and finalize payoutredeem directly against paper CTF stateUntil settlement confirms, a matched fill is not a confirmed position. Until final resolution, a settled Outcome Share is not redeemable Collateral.
Safety Checks
Section titled “Safety Checks”- Paper and production order books are separate.
- Paper and production contract registries are separate.
- Paper and production databases or schemas must be separate for money-like state.
- Paper builds refuse Polygon mainnet signing.
- Production builds refuse Amoy signing.
- Paper incident controls may stop new risk but must preserve cancellation, settlement retry, and redemption paths where rules permit.
Operator Drill Endpoints
Section titled “Operator Drill Endpoints”GET /api/paper/statusGET /api/paper/admin/audit-logPOST /api/paper/admin/order-intake/pausePOST /api/paper/admin/order-intake/resumePOST /api/paper/admin/markets/{marketId}/close-onlyPOST /api/paper/admin/settlement/retryPOST /api/paper/admin/incidents/notesIncident controls stop new risk. They must preserve cancellation, settlement retry, and redemption paths where market rules permit.
Paper Flow Coverage
Section titled “Paper Flow Coverage”Paper Trading is expected to cover faucet idempotency, signed order intake, WebSocket updates, settlement, portfolio projection, resale, close, resolve, finalize, and redemption before equivalent production flows are enabled.