Depositi e prelievi

I dati della blockchain di cui un client ha bisogno

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: il programma Seeryx (gli account dei mercati derivano da esso); mint: USDC. onChainTrading: ogni ordine, divisione e unione deve essere firmato. relayed: Seeryx paga la commissione di rete delle tue transazioni.
• finePrices: limiti in decimi di centesimo sotto 1¢ e sopra 99¢. budgetBuys: gli acquisti a mercato sono firmati con budget (PMO4). maxSessionTtl: la durata massima di una sessione di trading, in secondi; withdrawDelay: l’attesa di un prelievo differito, in secondi. depositFee e withdrawFee in USDC.

Gli USDC nel tuo wallet, i tuoi fondi nel programma, gli USDC in arrivo

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

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

• wallet: USDC nel wallet non ancora depositati. account: fondi nel programma, null finché il primo deposito non apre l’account. incoming: USDC arrivati al tuo indirizzo di deposito e in viaggio verso il tuo saldo.

Dopo un deposito o un prelievo: rileggi subito il programma

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

{ "ok": true }

Prepara una tua transazione da far firmare al wallet

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 è una transazione v0 in base64 con Seeryx come pagatore delle commissioni e tutti gli slot di firma vuoti. Firmala con il wallet (solo firma, non inviarla), poi inviala con POST a /api/relay/submit.
• Ogni deposito paga la commissione di deposito (depositFee di GET /api/funds) nella stessa transazione; il resto viene accreditato. Un primo deposito deve lasciare almeno 1 USDC dopo la commissione: è quello che apre il tuo conto.
• close_session annulla i tuoi ordini in attesa e disattiva subito la chiave di sessione (i suoi ordini ricevono trading_paused), anche prima che la transazione venga inviata.

Invia una transazione preparata dopo che il tuo wallet l’ha firmata

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

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

• Seeryx aggiunge la propria firma, verifica tutte le firme e invia la transazione a Solana; signature è il suo id. Attendi la conferma con qualsiasi RPC Solana (getSignatureStatuses).

Un prelievo immediato, da far firmare al wallet

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 }

• Firma la transazione con il wallet e inviala tramite /api/relay/submit. accountFee è la commissione di prelievo, trattenuta dall’importo. Con network e token la risposta contiene anche bridge { receive, fee, seconds }.

Cosa consegna un prelievo verso un’altra rete

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 è la commissione di prelievo; networkFee il costo del bridge dell’altra rete, una stima.

Reti e token da cui può provenire un deposito

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 su Solana, senza bridge. auto: ciò che arriva al tuo indirizzo di deposito viene aggiunto automaticamente al tuo saldo. withdraw: un prelievo può essere consegnato lì.

Il tuo indirizzo di deposito personale per un token su una rete

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 }

• Sempre lo stesso indirizzo per il tuo wallet e il tuo percorso. Invia almeno min.

Ritrova un deposito inviato con un altro token o su un’altra rete

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

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

• Per USDC inviati all’indirizzo mostrato per USDT, o a un indirizzo su una rete diversa da quella per cui era stato creato: il bridge ricontrolla e inoltra ciò che trova. amount è espresso nelle unità più piccole del token.