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.

Returns your current position on the Futuur leaderboard. Use this endpoint to track your standing relative to other traders and monitor how your score changes over time.

​
Endpoint

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

​
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

​
rank
integer
required
Your current position on the leaderboard. Lower is better — rank 1 is the top trader.
​
score
number
required
Your cumulative score used to determine your rank position.
​
total_users
integer
required
The total number of ranked users. Use this alongside rank to calculate your percentile.

​
Example

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

{
  "rank": 127,
  "score": 8540.5,
  "total_users": 15000
}