Account information

Returns details about your authenticated account, including your username, email address, wallet balances, and account status. For ledger balances broken out by currency, use GET /me/balances/.

Endpoint

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

Authentication

This endpoint requires HMAC-SHA512 authentication. Include the following headers with every request:

Header	Description
`Key`	Your public API key
`Timestamp`	Current Unix timestamp
`HMAC`	SHA-512 signature of the request

Parameters

This endpoint takes no parameters.

Response

Returns a UserPrivate object.

integer

required

Unique numeric identifier for your account.

string

Your account username.

string

required

The email address associated with your account.

object

required

Dictionary of balances keyed by currency code (for example, OOM, USDC, USDT, USD). Values are decimal strings.

boolean

required

Whether you have confirmed your email address.

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.

string

ISO 8601 timestamp of when you joined Futuur.

Register a Safe address

If you use a Safe smart account, register it with Futuur by calling POST /me/safe/. The request body requires both a safe_address and a chain_id. On success, the response is the same UserPrivate object returned by GET /me/.

Example

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

{
  "id": 42,
  "username": "trader_jane",
  "email": "jane@example.com",
  "wallet": {
    "OOM": "5000.00",
    "USDC": "100.00",
    "USDT": "0.00",
    "USD": "0.00"
  },
  "email_confirmed": true,
  "real_currency_enabled": true,
  "kyc_status": "approved",
  "date_joined": "2024-03-15T10:00:00Z"
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Parameters

Response

Register a Safe address

Example

​Endpoint

​Authentication

​Parameters

​Response

​Register a Safe address

​Example

Endpoint

Authentication

Parameters

Response

Register a Safe address

Example