Skip to content
Amoeba FarmAmoeba FarmAmoeba Farm Docs

Read commands

Read commands never sign or send anything. Add --json to any of them for structured output.

Name a market by symbol (ramx: the open RAMX market that expires first), by name (ramx-nov26) or by address. --expiry nov26 (or 2026-11) picks another expiry for a bare symbol.

Markets

Section titled “Markets”
Terminal window
petri markets          # every market
petri market ramx      # one market

petri markets lists every futures market with its price, 24-hour change, index, 24-hour volume, settlement date and status:

MARKET        NAME          PRICE    24H  INDEX    VOL 24H  SETTLES             STATUS
NANDX Oct 26  nandx-oct26   93.96  -6.44  91.89  2,662,769  Nov 1 (in 16d 23h)  open
RAMX Oct 26   ramx-oct26    96.70  -2.00  95.00  2,767,922  Nov 1 (in 16d 23h)  open
NANDX Nov 26  nandx-nov26  108.24  +8.64  91.89  2,521,134  Dec 1 (in 46d 23h)  open
RAMX Nov 26   ramx-nov26    93.16  -7.04  95.00  2,354,753  Dec 1 (in 46d 23h)  open

petri market ramx (or petri markets ramx) shows one market:

RAMX Oct 26 (ramx-oct26) · open · settles 2026-11-01 00:00 UTC (in 16d 23h)
  Price       96.70 last trade · -2.00 in 24h
  Index       95.00 · 24s ago
  Suggested   55–135, where the index can reach by expiry (2σ)
  Book        buy at 96.97 · sell at 95.37 on 55–135
  Activity    2,767,922 lots in 24h · 1,171 trades · 156 open positions
  Settlement  the RAMX index at expiry, from the oracle (period live)
  • Price is the entry of the last trade.
  • Index is the latest reading of the market’s index, and how old it is.
  • Suggested is the range the index can reach by expiry (2σ). Orders end there on the winning side unless you choose another end.
  • Book is the best price to buy and to sell the suggested range.
  • Settlement names what the market settles on, and the state of its oracle period.

The status is open while the market trades and paused while it doesn’t, for example between expiry and settlement. A settled market shows settled at its settlement value. See Settlement.

Book

Section titled “Book”
Terminal window
petri book ramx                   # the suggested range
petri book ramx --range 90-120    # another range
petri book ramx --depth 4         # 4 price levels a side (default 10)

Different ranges trade against each other, so each range has its own depth. Sell rows are the prices you can buy the range at; buy rows are the prices you can sell it at.

RAMX Oct 26 · range 55–135 (suggested)
        PRICE   LOTS   TOTAL
  sell  97.63  7,670  23,901
  sell  97.41  6,421  16,231
  sell  97.19  5,351   9,810
  sell  96.97  4,459   4,459
  ── 96.17 mid, 1.60 wide · index 95.00 ──
  buy   95.37  4,459   4,459
  buy   95.05  5,351   9,810
  buy   94.73  6,421  16,231
  buy   94.43    311  16,542

Trades

Section titled “Trades”
Terminal window
petri trades ramx              # the last 20 trades
petri trades ramx --limit 50

Each row shows the time, side, lots, price and the range that traded.

Chart

Section titled “Chart”
Terminal window
petri chart ramx               # the last 24 hours
petri chart ramx 7d            # 1h, 24h, 7d, 30d or all
petri chart ramx 30d --height 20

The chart prints the price with a volume strip, and the window’s open, high, low, last price, change and the index. --height sets its height in rows (default 14).

Positions

Section titled “Positions”
Terminal window
petri positions                # your wallet
petri positions <OWNER>        # any wallet

petri positions lists, for each market, your free cash, your positions and your resting orders:

RAMX Oct 26 (ramx-oct26) · index 95.00 · cash $4,623.72 free
  #    SIDE   RANGE     LOTS   ENTRY     PAID        MAX       P&L  CLOSE NOW
  78   long   110–134  4,504  115.79  $260.70  $1,080.96  -$260.70     $20.17
  189  short  84–106   3,898  101.11  $190.62    $857.56  +$238.16    $399.91
Column Meaning
# The position number, for petri close.
RANGE, LOTS, ENTRY The range, its size and the average entry.
PAID What you put in: the most you can lose.
MAX The most the position can pay at settlement.
P&L The position valued at the index now, or at the settlement value once the market has settled.
CLOSE NOW What selling it on the book would return now.

Resting orders follow under Orders, with their number (for petri cancel) and the cash each one holds. Free cash is yours to withdraw. petri account and petri pos are other names for petri positions.

History

Section titled “History”
Terminal window
petri history                    # your wallet, newest first
petri history <OWNER> --limit 10

petri history lists trades, orders, cancels, deposits, withdrawals, nettings and settlements across markets. It shows 50 rows unless you set --limit.

TIME (UTC)      MARKET       EVENT   DETAIL
10-15 00:28:54  RAMX Oct 26  long    3,898 lots · 84–106 at 100.01 · paid $624.23
10-15 00:28:54  RAMX Oct 26  netted  3,898 lots · 84–106 · freed $857.56
10-15 00:18:29  RAMX Oct 26  short   1,509 lots · 106–135 at 114.34 · paid $311.71

A long and a short you hold on exactly the same range cancel out. Petri shows that as netted, with the cash it freed.

Wallet

Section titled “Wallet”
Terminal window
petri wallet                  # your wallet
petri wallet <OWNER>          # any wallet
petri wallet address          # just your wallet's address

petri wallet shows the address, its SOL and USDC, and its free cash in each market.

Status

Section titled “Status”
Terminal window
petri status

petri status checks the cluster and its clock, the futures API, each trusted program, the markets and your wallet. Run it first when something does not work.

Oracle

Section titled “Oracle”
Terminal window
petri oracle                             # every oracle month
petri oracle months ramx                 # RAMX months: phase, sources, settlement status
petri oracle latest                      # the most recently updated month
petri oracle history                     # months by last update, newest first
petri oracle catalog                     # every oracle period with its settlement time
petri oracle sources ramx                # the sources of RAMX's months
petri oracle sources ramx --expiry oct26 --query ddr5
petri oracle recipe ramx                 # buckets with their weights and sources
petri oracle candidates                  # source candidates from research agents
petri oracle collateral                  # your USDC bond collateral in the oracle

sources and recipe show up to 40 rows per month; change this with --limit. --query matches a bucket, a source ID or address, a status or a URL. Candidates are suggestions from research agents and carry no oracle weight.

See How the oracle works and Evidence rules.

See Trading and wallet actions for commands that move funds, and the Command reference for everything else.