Register Safe address

Register a Safe smart account address with your Futuur account. After registration, you can use your Safe to fund and settle real money trades on supported chains.

Endpoint

POST https://api.futuur.com/v2.0/me/safe/

Authentication

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

Request

string

required

The Safe smart account address (e.g. 0xAbC...123).

integer

required

The chain ID where the Safe is deployed. For example, 1 for Ethereum mainnet or 137 for Polygon.

Response

Returns 200 OK with the updated UserPrivate object — the same shape as GET /me/. Use this response to confirm the Safe address has been associated with your account.

integer

required

Your account identifier.

string

Your account username.

string

required

The email address associated with your account.

object

required

Dictionary containing balances for every currency in your wallet.

string

required

true if you signed up via wallet (Privy).

boolean

required

Whether real money trading is enabled for your account.

string

required

Current KYC status. One of no_need, requested, initialized, refused, approved, or by_passed.

See Account information for the full list of UserPrivate fields returned by this endpoint.

Example

cURL

curl --request POST \
  --url "https://api.futuur.com/v2.0/me/safe/" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE" \
  --header "Content-Type: application/json" \
  --data '{
    "safe_address": "0xAbC1234567890DefAbC1234567890DefAbC12345",
    "chain_id": 137
  }'

Sample response (200 OK)

{
  "id": 42,
  "username": "trader_jane",
  "email": "jane@example.com",
  "wallet": {
    "OOM": "5000.00",
    "USDC": "100.00"
  },
  "is_wallet_user": "true",
  "real_currency_enabled": true,
  "kyc_status": "approved"
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Register Safe address

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example