Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.futuur.com/llms.txt

Use this file to discover all available pages before exploring further.

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/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

​
safe_address
string
required
The Safe smart account address (e.g. 0xAbC...123).
​
chain_id
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.
​
id
integer
required
Your account identifier.
​
username
string
Your account username.
​
email
string
required
The email address associated with your account.
​
wallet
object
required
Dictionary containing balances for every currency in your wallet.
​
is_wallet_user
string
required
true if you signed up via wallet (Privy).
​
real_currency_enabled
boolean
required
Whether real money trading is enabled for your account.
​
kyc_status
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/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"
}