Skip to content
Pina AMM

The pina-amm CLI

pina-amm drives every Pina AMM instruction from the terminal. It derives every PDA, vault, and associated token account, so you only supply the values you actually choose: a tier index, two mints, and amounts.

Terminal window
cargo install pina_amm_cli
pina-amm --help

Global options

Option Default Meaning
-u, --url devnet ($SOLANA_URL) mainnet, devnet, testnet, localhost, or an https:// URL. Plain http:// is only accepted for localhost
-k, --keypair ~/.config/solana/id.json ($PINA_AMM_KEYPAIR) Signer and fee payer, in the Solana CLI’s JSON format
--simulate off Simulate and print compute units instead of sending
--json off Print one JSON object per command

Amounts are always base units, the integer a token account stores. One USDC with 6 decimals is 1000000.

Fee tiers

Terminal window
# Create tier 0: 0.25% trade fee, 16% of it to the protocol, no creator fee.
# The signer must be the program's upgrade authority.
pina-amm config create --index 0 --trade-fee-rate 2500 --protocol-fee-rate 160000


# A tier only a launchpad PDA may create pools in, with a 0.5% creator fee.
pina-amm config create --index 100 --trade-fee-rate 2500 --protocol-fee-rate 160000 \
  --creator-fee-rate 5000 --pool-creator-authority <LAUNCHPAD_PDA>


pina-amm config show --index 0
pina-amm config update --index 0 --trade-fee-rate 3000 --protocol-fee-rate 160000 --new-authority <MULTISIG>

Updating a tier never changes existing pools.

Pools

Terminal window
pina-amm pool create --config 0 \
  --mint-a <MINT_A> --amount-a 1000000000 \
  --mint-b <MINT_B> --amount-b 2000000000 \
  --creator-fee-mode mint-b


pina-amm pool show --pool <POOL>
pina-amm pool set-creator --pool <POOL> --new-creator <ADDRESS>

You can pass the mints in either order; the CLI sorts them. --creator-fee-mode is input (default), mint-a, or mint-b. pool show prints the reserves (excluding accrued fees), the price of token 0 in token 1 base units, and the fees waiting to be collected.

Trading

Terminal window
pina-amm quote --pool <POOL> --sell <MINT> --amount-in 1000000
pina-amm swap  --pool <POOL> --sell <MINT> --amount-in 1000000 --slippage-bps 50
pina-amm swap  --pool <POOL> --sell <MINT> --amount-out 500000

Each trade is first simulated with an open limit; the Swapped event the program emits is the quote. The CLI then sends the trade with the limit moved by --slippage-bps (default 50, 0.5%): a minimum output for --amount-in, a maximum input for --amount-out. If the output token account does not exist yet, it is created in the same transaction.

Liquidity

Terminal window
pina-amm deposit  --pool <POOL> --lp-amount 1000000 --slippage-bps 50
pina-amm withdraw --pool <POOL> --lp-amount 1000000 --slippage-bps 50

Both are quoted by simulation the same way, and missing token accounts are created first.

Fees

Terminal window
pina-amm fees collect-protocol --pool <POOL>   # signer: the tier authority
pina-amm fees collect-creator  --pool <POOL>   # signer: the pool creator

Fees are paid to the signer’s associated token accounts, which are created if needed.

Scripting

With --json, every command prints exactly one JSON object on stdout, in one of two shapes.

Commands that act (config create, config update, pool create, pool set-creator, quote, swap, deposit, withdraw, and fees ...) print an envelope. signature is null for quote and under --simulate:

Terminal window
$ pina-amm --json quote --pool <POOL> --sell <MINT> --amount-in 1000000
{"action":"quote","details":{"amount_in":1000000,"amount_out":1813221,"compute_units":4682,...},"signature":null}

Commands that read (config show and pool show) print the decoded account fields at the top level, with no envelope:

Terminal window
$ pina-amm --json pool show --pool <POOL>
{"address":"...","lp_supply":2000000000,"reserve_0":1000000000,"reserve_1":4000000000,...}

The CLI exits with status 1 and a message on stderr when anything fails, including a failed simulation, which prints the program logs.