Deposits and withdrawals

The chain facts a client needs

curl "https://seeryx.com/api/funds"

{
  "mode": "chain", "cluster": "mainnet",
  "programId": "2uUbvYHqBH1HDVzABGPcqrjHodoBVcNkq6Nrv6MABaiv", "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "withdrawDelay": 60, "maxSessionTtl": 86400, "instantWithdraw": true, "withdrawFee": 1.0, "depositFee": 1.0,
  "onChainTrading": true, "fees": { "rateBps": 700, "rebateBps": 2000 },
  "relayed": true, "directDeposits": true, "finePrices": true, "budgetBuys": true, ...
}

• programId: the Seeryx program (market accounts are derived from it); mint: USDC. onChainTrading: every order, split and merge must be signed. relayed: Seeryx pays the network fee of your transactions.
• finePrices: limits in tenths of a cent below 1¢ and above 99¢. budgetBuys: market buys are signed by budget (PMO4). maxSessionTtl: the longest trading session, in seconds; withdrawDelay: the wait of a delayed withdrawal, in seconds. depositFee and withdrawFee in USDC.

USDC in your wallet, your cash in the program, USDC on its way

curl "https://seeryx.com/api/funds/wallet" \
  -H "X-Auth-Token: $TOKEN"

{ "wallet": 200, "account": null, "sol": 0, "incoming": 0 }

• wallet: USDC in the wallet not deposited yet. account: cash in the program, null until the first deposit opens it. incoming: USDC that reached your deposit address and is on its way to your balance.

After a deposit or withdrawal: read the program now

curl -X POST "https://seeryx.com/api/funds/refresh" \
  -H "X-Auth-Token: $TOKEN"

{ "ok": true }

Prepare a transaction of yours for the wallet to sign

curl -X POST "https://seeryx.com/api/relay" \
  -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"deposit","amount":10}'

{ "transaction": "AQAB..." }

• transaction is a base64 v0 transaction with Seeryx as the fee payer and every signature slot empty. Sign it with the wallet (sign only, do not send it), then POST it to /api/relay/submit.
• Every deposit pays the deposit fee (depositFee of GET /api/funds) in the same transaction; the rest is credited. A first deposit must leave at least 1 USDC after the fee: it opens your account.
• close_session cancels your resting orders and stops the session key at once (its orders get trading_paused), even before the transaction is sent.

Send a prepared transaction after your wallet signed it

curl -X POST "https://seeryx.com/api/relay/submit" \
  -H "X-Auth-Token: $TOKEN"

{ "signature": "5VERv8NM..." }

• Seeryx adds its own signature, checks every signature and sends the transaction to Solana; signature is its id. Wait for confirmation with any Solana RPC (getSignatureStatuses).

An immediate withdrawal, for the wallet to sign

curl -X POST "https://seeryx.com/api/withdraw-now" \
  -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":25}'

{ "transaction": "AQAB...", "accountFee": 1 }

• Sign the transaction with the wallet and send it through /api/relay/submit. accountFee is the withdrawal fee, taken from the amount. With network and token the answer also has bridge { receive, fee, seconds }.

What a withdrawal to another network delivers

curl -X POST "https://seeryx.com/api/withdraw/quote" \
  -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":20,"network":"base","token":"USDC"}'

{ "receive": 18.89, "fee": 0.11, "networkFee": 0.11, "bridgeFee": 1, "seconds": 1 }

• bridgeFee is the withdrawal fee; networkFee the cost of the other network's bridge, an estimate.

Networks and tokens a deposit can come from

curl "https://seeryx.com/api/deposit/options"

{ "routes": [{ "network": "solana", "token": "USDC", "min": 1, "available": true, "reason": null, "direct": true, "auto": true, "withdraw": true },
  { "network": "bsc", "token": "USDT", "min": 3, "available": true, "reason": null, "direct": false, "auto": true, "withdraw": true }, ...] }

• direct: USDC on Solana, no bridge. auto: what arrives at your deposit address is added to your balance by itself. withdraw: a withdrawal can deliver there.

Your own deposit address for a token on a network

curl -X POST "https://seeryx.com/api/deposit/address" \
  -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"network":"solana","token":"USDC"}'

{ "network": "solana", "token": "USDC", "address": "7xKXtg2C...", "min": 1, "direct": true, "auto": true }

• The same address each time for your wallet and route. Send at least min.

Find a deposit sent with another token or on another network

curl -X POST "https://seeryx.com/api/deposit/recover" \
  -H "X-Auth-Token: $TOKEN"

{ "found": [{ "address": "0x09a3...", "network": "ethereum", "token": "USDC", "amount": "25000000" }] }

• For USDC sent to the address shown for USDT, or to an address on another network than it was made for: the bridge looks again and forwards what it finds. amount is in the token's smallest units.