Autenticación

Todos los endpoints de trading requieren un sessionId, obtenido mediante el protocolo de sesión en dos pasos. Una sesión está vinculada a una dirección de wallet (0xABC) y puede autenticarse con la propia wallet o con una API key registrada (0xXYZ). Las sesiones expiran tras un TTL fijo de 1 hora y pueden revocarse de forma explícita.

Handshake de sesión

1. POST /session/start con { “user”: “0xABC…” }: el servidor devuelve un challenge de un solo uso.
2. Calcule keccak256(challenge) y firme el hash resultante con eth_sign (firma cruda de 65 bytes).
3. POST /session/complete con { challengeId, signature }: el servidor verifica y devuelve un sessionId.
4. Utilice el sessionId en cada llamada a /session/*. Si expira o recibe 401, repita desde el paso 1.