Developers
The API.
Read the leaderboard, the pot, recent payouts and player cards from your own bot, overlay or site. It is read only and needs no key.
Base address
https://datrophi.com/api/v1
Every endpoint answers a plain GET with JSON and can be called from a browser on any site. Try it:
curl https://datrophi.com/api/v1/status
Endpoints
GET /status
Whether payouts are on, the token address, the pot balance, fees waiting to be claimed, which platforms are open and the running totals.
GET /leaderboard
Linked players ranked by SOL earned, with their achievements, points and player card link.
Options: limit (1 to 100, default 50), offset
GET /rarest
The rarest achievements found so far, rarest first.
Options: limit (1 to 100, default 50)
GET /achievements
Every GTA VI achievement with its grade, how rare it is, its points and the share of the pot one unlock takes. Secret ones are marked, so you can hide them.
GET /payouts
The most recent payouts, newest first, each with its Solana transaction.
Options: limit (1 to 50, default 20)
GET /players/{platform}/{id}
One player card: rank, SOL earned, achievements by grade. Platform is one of psn, xbox, steam, rockstar, epic. The id is the one in a player card link.
GET /wallets/{wallet}
The game accounts linked to a wallet and what each has earned.
Example answer
This is the shape of /status. The values here are examples.
{
"live": true,
"token": "the token address",
"pot": { "address": "the pot wallet", "lamports": 12500000000, "sol": 12.5,
"feesWaitingLamports": 300000000, "feesWaitingSol": 0.3 },
"minHoldTokens": 1000000,
"platforms": [{ "platform": "psn", "name": "PlayStation", "open": true }],
"totals": { "players": 0, "payouts": 0, "paidLamports": 0, "paidSol": 0,
"claimedLamports": 0, "claimedSol": 0 },
"updatedAt": 1794990000000
}Good to know
- Read only
- Nothing here can link an account, change a setting or move money. Those need a signature from the wallet involved, on the site.
- Limit
- 60 requests a minute for each caller. Every answer carries how many you have left. Past the limit you get a 429 with the seconds to wait.
- Freshness
- Answers are built from saved data and refresh about every 20 seconds, so asking more often than that returns the same thing.
- Amounts
- Given in lamports with the same value in SOL beside it. 1 SOL is 1,000,000,000 lamports.
- Times
- Milliseconds since 1970, in UTC.
- What is public
- Only what the site already shows: player names, wallets, achievements and payouts. Nothing private is returned.
- Changes
- This is version 1. Fields may be added. If something has to change shape it will get a new version and this one will keep working.