Поповнення й виведення

Дані блокчейну, потрібні клієнту

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: програма Seeryx (від неї похідні акаунти ринків); mint: USDC. onChainTrading: кожен ордер, розділення й об’єднання має бути підписаним. relayed: комісію мережі за ваші транзакції сплачує Seeryx.
• finePrices: лімітні ціни з кроком 0,1¢ нижче 1¢ і вище 99¢. budgetBuys: ринкові купівлі підписуються за бюджетом (PMO4). maxSessionTtl: найдовша торгова сесія, у секундах; withdrawDelay: очікування відкладеного виведення, у секундах. depositFee і withdrawFee — у USDC.

USDC у вашому гаманці, ваші кошти в програмі й USDC у дорозі

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

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

• wallet: USDC у гаманці, ще не зараховані на рахунок. account: кошти в програмі, null, доки перше поповнення не відкриє рахунок. incoming: USDC, що надійшли на вашу адресу для поповнення й прямують на ваш баланс.

Після поповнення чи виведення: негайно прочитати стан програми

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

{ "ok": true }

Підготувати вашу транзакцію для підпису гаманцем

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 — транзакція v0 у base64, у якій платником комісії є Seeryx, а всі слоти підписів порожні. Підпишіть її гаманцем (лише підпишіть, не надсилайте), потім надішліть POST-запитом на /api/relay/submit.
• Кожне поповнення сплачує комісію за поповнення (depositFee з GET /api/funds) у тій самій транзакції; решту зараховують. Після першого поповнення має залишитися щонайменше 1 USDC після комісії: воно відкриває ваш рахунок.
• close_session скасовує ваші ордери в книзі й одразу зупиняє ключ сесії (його ордери отримують trading_paused) — ще до того, як транзакцію надіслано.

Надіслати підготовлену транзакцію після підпису гаманцем

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

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

• Seeryx додає свій підпис, перевіряє всі підписи й надсилає транзакцію в мережу Solana; signature — її ідентифікатор. Чекайте підтвердження через будь-який RPC Solana (getSignatureStatuses).

Миттєве виведення для підпису гаманцем

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 }

• Підпишіть транзакцію гаманцем і надішліть через /api/relay/submit. accountFee — комісія за виведення, що утримується із суми. З network і token відповідь також містить bridge { receive, fee, seconds }.

Скільки надійде під час виведення в іншу мережу

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 — комісія за виведення; networkFee — орієнтовна вартість мосту іншої мережі.

Мережі й токени, з яких можна поповнити рахунок

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 у мережі Solana, без мосту. auto: те, що надходить на вашу адресу для поповнення, автоматично зараховується на ваш баланс. withdraw: туди можна вивести кошти.

Ваша власна адреса для поповнення токеном у певній мережі

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 }

• Для вашого гаманця й маршруту щоразу та сама адреса. Надсилайте щонайменше min.

Знайти поповнення, надіслане іншим токеном або в іншій мережі

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

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

• Для USDC, надісланих на адресу, показану для USDT, або на адресу в іншій мережі, ніж та, для якої її створено: міст шукає знову й пересилає те, що знайде. amount — у найменших одиницях токена.