Depósitos y retiros

Los datos de la cadena de bloques que necesita un cliente

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: el programa de Seeryx (las cuentas de mercado se derivan de él); mint: USDC. onChainTrading: cada orden, división y combinación debe estar firmada. relayed: Seeryx paga la comisión de red de tus transacciones.
• finePrices: límites en décimas de centavo por debajo de 1¢ y por encima de 99¢. budgetBuys: las compras de mercado se firman por presupuesto (PMO4). maxSessionTtl: la sesión de trading más larga, en segundos; withdrawDelay: la espera de un retiro diferido, en segundos. depositFee y withdrawFee, en USDC.

USDC en tu billetera, tu efectivo en el programa, USDC en camino

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

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

• wallet: USDC en la billetera aún no depositados. account: efectivo en el programa, null hasta que el primer depósito abre la cuenta. incoming: USDC que llegaron a tu dirección de depósito y están en camino a tu saldo.

Tras un depósito o un retiro: leer el programa ahora

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

{ "ok": true }

Preparar una transacción tuya para que la firme la billetera

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 es una transacción v0 en base64 con Seeryx como pagador de la comisión y todos los espacios de firma vacíos. Fírmala con la billetera (solo firmar, sin enviarla) y, después, envíala con POST a /api/relay/submit.
• Cada depósito paga la comisión de depósito (depositFee de GET /api/funds) en la misma transacción; el resto se abona. Un primer depósito debe dejar al menos 1 USDC después de la comisión: abre tu cuenta.
• close_session cancela tus órdenes en el libro y detiene la clave de sesión al instante (sus órdenes reciben trading_paused), incluso antes de que se envíe la transacción.

Enviar una transacción preparada después de que tu billetera la firme

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

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

• Seeryx añade su propia firma, comprueba todas las firmas y envía la transacción a Solana; signature es su id. Espera la confirmación con cualquier RPC de Solana (getSignatureStatuses).

Un retiro inmediato, para que lo firme la billetera

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 transacción con la billetera y envíala a través de /api/relay/submit. accountFee es la comisión de retiro, que se descuenta del importe. Con network y token, la respuesta incluye también bridge { receive, fee, seconds }.

Lo que entrega un retiro a otra red

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 es la comisión de retiro; networkFee, el coste estimado del puente de la otra red.

Redes y tokens desde los que puede llegar un depósito

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 en Solana, sin puente. auto: lo que llega a tu dirección de depósito se añade a tu saldo automáticamente. withdraw: un retiro puede entregar allí.

Tu propia dirección de depósito para un token en una red

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 }

• Siempre la misma dirección para tu billetera y esa ruta. Envía al menos min.

Encontrar un depósito enviado con otro token o en otra red

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

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

• Para USDC enviados a la dirección mostrada para USDT, o a una dirección en una red distinta de aquella para la que se creó: el puente vuelve a buscar y reenvía lo que encuentra. amount está en las unidades mínimas del token.