Skip to main content
GET
Get public user accuracy score
Returns a user’s accuracy score by Ethereum address: how many resolved markets they won and lost, the total resolved, and when tracking started. Public, no authentication required.

When to use

Use this endpoint to show an accuracy stat on a public profile, feed, or leaderboard view. Pass any wallet address; you do not need to be that user.

Response contract

The 200 body is either a stats object or null:
  • An object with won, lost, total, and since (ISO date string of the earliest resolved market tracked) when accuracy data exists for the address.
  • null when no accuracy data is available yet. Treat null as “no data”, not as an error.
Compute the accuracy percentage yourself as won / total.

Address handling

The account path parameter accepts a checksummed (EIP-55) or lowercase Ethereum address. The API normalizes it server-side, so both forms resolve to the same user. A malformed address returns 400 Bad Request.

Caching

Successful responses (object or null) carry Cache-Control: public, max-age=0, s-maxage=15, so CDN edges may serve a cached copy for up to 15 seconds. Error responses are no-store. The endpoint is feature-flagged. When accuracy scoring is disabled platform-wide, it returns 404 Not Found.

Path Parameters

account
string
required

User Ethereum address

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

Response

object | null

User accuracy statistics, or null when no accuracy data is available

won
number
required

Number of markets won

lost
number
required

Number of markets lost

total
number
required

Total resolved markets

since
string
required

Earliest resolved date tracked for this user (ISO date string)