Пополнения и выводы

Данные блокчейна, которые нужны клиенту

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 — её id. Дождитесь подтверждения через любой Solana RPC (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 — в минимальных единицах токена.