Profiles

My Fees

GET

/api/v1/wallet/{address}/fees

Fees paid by any wallet: every fee (trades, bets paid in a BASIS token, loan, vault, vesting and leverage fees), grouped by the asset it was paid in, with a USD total (null unless every row is priced), relayUnresolved and the native-coin categories. Database only, no chain read. Alias for your own wallet: GET /api/v1/me/fees.

Auth: API Key (the /me alias: Session or API Key)

Query Parameters

Param	Description
from	ISO date, or digits = unix milliseconds (default: the epoch)
to	ISO date, or digits = unix milliseconds (default: now)
byCategory	`true`: one row per asset and fee category

Response

{
  "wallet": "0x...",
  "from": "1970-01-01T00:00:00.000Z",
  "to": "2026-10-01T12:00:00.000Z",
  "data": [
    {
      "pairAsset": "0x...",
      "category": "spot_trade",
      "fees": "1800000",
      "baseFees": "1800000",
      "retained": "0",
      "feesUsdE18": "1800000000000000000",
      "n": 12,
      "symbol": "USDG",
      "decimals": 6
    }
  ]
}

fees, baseFees and retained are raw units of pairAsset (decimals; the zero address is the native coin). feesUsdE18 is USD × 1e18, null when unknown. category is present only with byCategory=true. Referral earnings are not fees: they are in /api/v1/me/referrals (onchain).

200 Fees returned400 Invalid from / to401 Not authenticated503 Fees not deployed on this network

GET

/api/v1/wallet/{address}/earnings

Creator fee earnings of any wallet (paid as a token's creator or creator-fee recipient), grouped by the pair asset they were paid in, plus byToken, redirected (creator shares that went to the CEO instead) and holder rewards. Database only, no chain read. Alias for your own wallet: GET /api/v1/me/earnings.

Auth: API Key (the /me alias: Session or API Key)

Query parameters from and to, as above.

Response

{
  "wallet": "0x...",
  "from": "1970-01-01T00:00:00.000Z",
  "to": "2026-10-01T12:00:00.000Z",
  "data": [
    { "pairAsset": "0x...", "symbol": "USDG", "decimals": 6, "amount": "42000000", "amountUsdE18": "42000000000000000000", "n": 57 }
  ]
}

amount is raw units of pairAsset (decimals). amountUsdE18 is USD × 1e18, null when any payout of the group has no known USD value.

200 Earnings returned400 Invalid from / to401 Not authenticated503 Not deployed on this network