Skip to main content
Returns details about your authenticated account, including your username, email address, and current balances across all supported currencies.

​
Endpoint

GET https://api.futuur.com/me/

​
Authentication

This endpoint requires HMAC-SHA512 authentication. Include the following headers with every request:
HeaderDescription
KeyYour public API key
TimestampCurrent Unix timestamp
HMACSHA-512 signature of the request

​
Parameters

This endpoint takes no parameters.

​
Response

​
id
integer
required
Unique numeric identifier for your account.
​
username
string
required
Your account username.
​
email
string
required
The email address associated with your account.
​
oom_balance
string
required
Your play money balance in OOM (Opinion on Markets). Returned as a decimal string.
​
usdc_balance
string
required
Your real money balance in USDC. Returned as a decimal string.
​
usdt_balance
string
Your real money balance in USDT. Returned as a decimal string.
​
usd_balance
string
Your real money balance in USD. Returned as a decimal string.
​
is_email_confirmed
boolean
required
Whether you have confirmed your email address.

​
Register a Safe address

If you use a Safe smart account, you can register your Safe address with Futuur by calling POST /me/safe/. Submit your Safe address in the request body: 
curl --request POST \
  --url https://api.futuur.com/me/safe/ \
  --header 'Key: YOUR_PUBLIC_KEY' \
  --header 'Timestamp: 1712345678' \
  --header 'HMAC: YOUR_HMAC_SIGNATURE' \
  --header 'Content-Type: application/json' \
  --data '{"address": "0xYourSafeAddress"}'
On success, the response is the same UserPrivate object returned by GET /me/.

​
Example

curl --request GET \
  --url https://api.futuur.com/me/ \
  --header 'Key: YOUR_PUBLIC_KEY' \
  --header 'Timestamp: 1712345678' \
  --header 'HMAC: YOUR_HMAC_SIGNATURE'

{
  "id": 42,
  "username": "trader_jane",
  "email": "jane@example.com",
  "oom_balance": "5000.00",
  "usdc_balance": "100.00",
  "usdt_balance": "0.00",
  "usd_balance": "0.00",
  "is_email_confirmed": true
}