datrophi

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.