Context

Understand Farcaster account context

Host: https://api.quotient.social

Get user reputation metrics for multiple users

post

Retrieves quotient scores and ranking for up to 1000 Farcaster users.

Body

application/json

Request model for reputation endpoint.

fidsinteger[] · max: 1000Required

List of Farcaster IDs (FIDs) to retrieve reputation for

api_keystringRequired

API key for authentication

Responses

200

Successfully retrieved reputation data

application/json

401

Unauthorized - Invalid API key

404

No users found with the provided FIDs

422

Validation Error

application/json

500

Internal Server Error

post

/v1/user-reputation

HTTPcURLJavaScriptPython

POST /v1/user-reputation HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "fids": [
    1
  ],
  "api_key": "text"
}

{
  "data": [
    {
      "fid": 1,
      "username": "text",
      "quotientScore": 1,
      "quotientRank": 1,
      "contextLabels": [
        "text"
      ],
      "topTrader": true,
      "topBuilder": true,
      "topTokenEvangelist": true
    }
  ],
  "count": 1
}

Quotient Score

Quotient Score is a variation of the PageRank algorithm optimized for Farcaster, measuring momentum and relevance based on the quantity and quality of incoming engagement.

The algorithm weights recent interactions more heavily and ignores follower counts to avoid advantages from automated/spam followers, focusing instead on genuine engagement patterns.

Quotient Score Tiers

Score Range	Quality Level	Description
<0.5	Inactive	Bot accounts, farmers, inactive users
0.5 - 0.6	Casual	Occasional users, low engagement. Potentially spam or bot accounts.
0.6 - 0.725	Active	Frequent contributors, solid engagement
0.75 - 0.8	Influential	High-quality content, strong network
0.8 - 0.89	Elite	Top-tier creators, community leaders
0.9+	Exceptional	Platform superstars, maximum influence

Context Labels

Label	Criteria considered	# Users
Top Trader	Trading frequency, volume, and profitability, as well as membership in high-signal trading communities (i.e. Bankr Club) and exclusive pre-sales (i.e. Fey)	~1,200
Top Token Evangelist	Buy volume generated through posting activity on Farcaster.	~1,100
Top Builder/Dev	Developer rewards earned for mini-apps, formal affiliation with project or company operating on Farcaster.	~800