Dépôts et retraits

Les informations de la blockchain dont un client a besoin

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 : le programme Seeryx (les comptes des marchés en sont dérivés) ; mint : USDC. onChainTrading : chaque ordre, scission et fusion doit être signé. relayed : Seeryx paie les frais de réseau de vos transactions.
• finePrices : limites en dixièmes de cent en dessous de 1¢ et au-dessus de 99¢. budgetBuys : les achats au marché sont signés par budget (PMO4). maxSessionTtl : la durée maximale d’une session de trading, en secondes ; withdrawDelay : l’attente d’un retrait différé, en secondes. depositFee et withdrawFee en USDC.

Les USDC de votre portefeuille, vos liquidités dans le programme, les USDC en cours d’arrivée

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

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

• wallet : USDC du portefeuille pas encore déposés. account : liquidités dans le programme, null jusqu’à ce que le premier dépôt ouvre le compte. incoming : USDC arrivés à votre adresse de dépôt et en route vers votre solde.

Après un dépôt ou un retrait : relire le programme immédiatement

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

{ "ok": true }

Préparer une de vos transactions pour que le portefeuille la signe

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 est une transaction v0 en base64 dont Seeryx est le payeur des frais et dont tous les emplacements de signature sont vides. Signez-la avec le portefeuille (signer uniquement, sans l’envoyer), puis envoyez-la par POST à /api/relay/submit.
• Chaque dépôt paie les frais de dépôt (depositFee de GET /api/funds) dans la même transaction ; le reste est crédité. Un premier dépôt doit laisser au moins 1 USDC après les frais : il ouvre votre compte.
• close_session annule vos ordres en attente et arrête aussitôt la clé de session (ses ordres reçoivent trading_paused), avant même l’envoi de la transaction.

Envoyer une transaction préparée après sa signature par votre portefeuille

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

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

• Seeryx ajoute sa propre signature, vérifie toutes les signatures et envoie la transaction à Solana ; signature en est l’identifiant. Attendez la confirmation avec n’importe quel RPC Solana (getSignatureStatuses).

Un retrait immédiat, à signer par le portefeuille

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 }

• Signez la transaction avec le portefeuille et envoyez-la via /api/relay/submit. accountFee correspond aux frais de retrait, prélevés sur le montant. Avec network et token, la réponse contient aussi bridge { receive, fee, seconds }.

Ce que livre un retrait vers un autre réseau

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 correspond aux frais de retrait ; networkFee, au coût du pont de l’autre réseau, à titre estimatif.

Réseaux et jetons depuis lesquels un dépôt peut arriver

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 sur Solana, sans pont. auto : ce qui arrive à votre adresse de dépôt est ajouté automatiquement à votre solde. withdraw : un retrait peut y être livré.

Votre propre adresse de dépôt pour un jeton sur un réseau

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 }

• La même adresse à chaque fois pour votre portefeuille et votre itinéraire. Envoyez au moins min.

Retrouver un dépôt envoyé avec un autre jeton ou sur un autre réseau

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

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

• Pour des USDC envoyés à l’adresse affichée pour l’USDT, ou à une adresse sur un autre réseau que celui pour lequel elle a été créée : le pont cherche de nouveau et transfère ce qu’il trouve. amount est exprimé dans les plus petites unités du jeton.