Networks & public settings
Networks
GET /api/networks
Returns accepted chains with RPC URLs and deployed contract maps. Keys commonly include:
factory/ mothership entryrfq(often same as mothership locally)opshuns_core(CLOB implementation or pair — registry naming may lag renames)token0,token1, premium tokens, faucet mocks (weth,usdc,wbtc,meme)
Use this to discover where to call executeIntent and which factory to use when creating pairs.
Coming soon: margin_rfq_core, margin_vault_factory, and related margin keys. Ignore them until Borrow is live.
Local Anvil (mix dev.local) upserts chain 31337 from priv/dev/anvil-31337.json on API boot.
Other public settings
| Endpoint | Purpose |
|---|---|
GET /api/payment-tokens | Payment token metadata (quote defaults + testnet faucet) |
GET /api/default-premium-tokens | Default premium token list |
GET /api/recommended-min-notional | Suggested minimum notionals |
GET /api/landing-page-settings | Trading landing CMS: default premium tokens, payment tokens, networks |
GET /api/filler-page-settings | Maker/filler page CMS content |
GET /api/bond-requirements | Per-token premium_bond_amount and fill_bond_amount (exclusive fills) |
The trading app also ships static RFQ allowlists / blacklists (underlyings, premium tokens, permitted CLOB addresses) compiled at build time — not an API round-trip. Custom 0x addresses can still be pasted in the token picker.
Indexer
| Endpoint | Purpose |
|---|---|
GET /api/indexer/status | Head, cursors, lag |
GET /api/indexer/cores | Discovered CLOB addresses |
Returns 503 when the indexer or RPC is unavailable.
Portfolio
GET /api/portfolio/:address — public snapshot of current CLOB holdings (balanceOf > 0), open book orders, and settled/closed holdings across all configured networks (networks[]). Optional ?chain_id= limits to one network.
Powers the trading Portfolio page. Full field list and statuses: Portfolio.