Einzahlungen und Abhebungen

Die Blockchain-Daten, die ein Client braucht

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: das Seeryx-Programm (Marktkonten werden davon abgeleitet); mint: USDC. onChainTrading: Jede Order, Aufteilung und Zusammenlegung muss signiert sein. relayed: Seeryx zahlt die Netzwerkgebühr deiner Transaktionen.
• finePrices: Limits in Zehntelcent unter 1¢ und über 99¢. budgetBuys: Market-Käufe werden per Budget signiert (PMO4). maxSessionTtl: die längste Handelssitzung in Sekunden; withdrawDelay: die Wartezeit einer verzögerten Abhebung in Sekunden. depositFee und withdrawFee in USDC.

USDC in deiner Wallet, dein Guthaben im Programm, USDC unterwegs

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

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

• wallet: USDC in der Wallet, noch nicht eingezahlt. account: Guthaben im Programm, null, bis die erste Einzahlung das Konto eröffnet. incoming: USDC, die deine Einzahlungsadresse erreicht haben und auf dem Weg zu deinem Guthaben sind.

Nach einer Einzahlung oder Abhebung: das Programm jetzt lesen

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

{ "ok": true }

Eine Transaktion von dir zum Signieren durch die Wallet vorbereiten

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 ist eine Base64-v0-Transaktion mit Seeryx als Gebührenzahler und lauter leeren Signaturplätzen. Signiere sie mit der Wallet (nur signieren, nicht senden) und sende sie dann per POST an /api/relay/submit.
• Jede Einzahlung zahlt die Einzahlungsgebühr (depositFee von GET /api/funds) in derselben Transaktion; der Rest wird gutgeschrieben. Eine erste Einzahlung muss nach der Gebühr mindestens 1 USDC übrig lassen: Sie eröffnet dein Konto.
• close_session storniert deine Orders im Orderbuch und stoppt den Sitzungsschlüssel sofort (seine Orders erhalten trading_paused), noch bevor die Transaktion gesendet ist.

Eine vorbereitete Transaktion senden, nachdem deine Wallet sie signiert hat

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

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

• Seeryx fügt seine eigene Signatur hinzu, prüft jede Signatur und sendet die Transaktion an Solana; signature ist ihre ID. Warte mit einem beliebigen Solana-RPC (getSignatureStatuses) auf die Bestätigung.

Eine Sofortabhebung, zum Signieren durch die 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 }

• Signiere die Transaktion mit der Wallet und sende sie über /api/relay/submit. accountFee ist die Abhebungsgebühr, vom Betrag abgezogen. Mit network und token enthält die Antwort außerdem bridge { receive, fee, seconds }.

Was eine Abhebung in ein anderes Netzwerk liefert

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 ist die Abhebungsgebühr; networkFee die Kosten der Bridge im anderen Netzwerk, eine Schätzung.

Netzwerke und Tokens, aus denen eine Einzahlung kommen kann

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 auf Solana, ohne Bridge. auto: Was an deiner Einzahlungsadresse ankommt, wird deinem Guthaben automatisch gutgeschrieben. withdraw: Eine Abhebung kann dorthin liefern.

Deine eigene Einzahlungsadresse für einen Token in einem Netzwerk

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 }

• Für deine Wallet und Route jedes Mal dieselbe Adresse. Sende mindestens min.

Eine Einzahlung finden, die mit einem anderen Token oder in einem anderen Netzwerk gesendet wurde

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

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

• Für USDC, die an die für USDT angezeigte Adresse gesendet wurden oder an eine Adresse in einem anderen Netzwerk als dem, für das sie erstellt wurde: Die Bridge sucht erneut und leitet weiter, was sie findet. amount ist in den kleinsten Einheiten des Tokens.