Register a signing wallet

This endpoint allows users to authorize a separate wallet (signer) to sign orders on behalf of their primary wallet (sender). Both wallets must provide cryptographic signatures to prove ownership and authorize the registration. Upon successful registration, an API key pair is generated for authenticated API access.

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth

x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sndr_addr?string

The user's primary wallet address that owns the account.

signer_addr?string

The signing wallet address to be authorized.

nonce?string

Unix timestamp in nanoseconds for replay attack prevention.

Formatuint64

sndr_sig?string

Cryptographic signature from the sender's wallet.

signer_sig?string

Cryptographic signature from the signer's wallet.

msg?string

Human-readable message for the signing payload.

nm?string

Friendly display name for the API key.

Response Body

`application/json`

Request

curl -X POST "https://api.obsdn.trade/auth/signers" \  -H "Content-Type: application/json" \  -d '{}'

Response

{
  "api_key": {
    "api_key": "string",
    "api_secret": "string",
    "nm": "string",
    "sndr": "string",
    "signer": "string",
    "crt_ts": "string",
    "exp_ts": "string",
    "is_ro": true
  }
}

Register a signing wallet

Authorization

Request Body

Response Body

200application/json

`application/json`