Score Calculation

Endpoint

GET /api/public/score

This endpoint allows retrieving detailed reputation score information for a user's wallet address. The endpoint calculates and returns comprehensive scoring metrics across multiple categories including protocol activity, network engagement, financial activity, and testnet participation. If the user has minted their reputation NFT, it returns the stored score data along with NFT information. If they haven't minted yet, it calculates their current score in real-time.

Authentication

Required: API Key

This endpoint requires authentication via API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Required	Description
wallet	string	Yes	The user's wallet address (must be a valid Ethereum address)
lensAccountAddress	string	No	The user's Lens Protocol account address (optional, must be a valid Ethereum address if provided)

Example Requests

cURL Example

GET "https://lensreputation.xyz/api/public/score?wallet=0xabc123...&lensAccountAddress=0xdef456..."
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Responses

200 - OK (User has minted the NFT)

When the user has minted their reputation NFT, the response includes the stored score data and NFT information:

{
  "minted": true,
  "score": {
    "total": 85,
    "protocol": 34,
    "network": 25,
    "financial": 20,
    "testnet": 6
  },
  "nft": {
    "tokenId": "123",
    "image": "https://example.com/nft-image.png"
  },
  "timestamp": 1741898964
}

200 - OK (User has not minted the NFT yet)

When the user hasn't minted their NFT, the endpoint calculates their current score in real-time:

{
  "minted": false,
  "score": {
    "total": 72,
    "protocol": 28,
    "network": 22,
    "financial": 18,
    "testnet": 4
  },
  "nft": null,
  "timestamp": null
}

Response Schema

Field	Type	Description
minted	boolean	Whether the user has minted their reputation NFT
score	object	Detailed score breakdown
score.total	number	Total reputation score
score.protocol	number	Protocol activity score (weighted)
score.network	number	Network engagement score (weighted)
score.financial	number	Financial activity score (weighted)
score.testnet	number	Testnet participation score (weighted)
nft	object|null	NFT information (null if not minted)
nft.tokenId	string	The NFT token ID
nft.image	string	URL to the NFT image
timestamp	number|null	Unix timestamp of NFT minting (null if not minted)

Error Responses

400 - Bad Request

Invalid or missing request parameters:

{
  "error": "Invalid or missing 'wallet' parameter."
}

Common causes:

• Missing wallet parameter

• Invalid wallet address format

• Invalid lensAccountAddress format

401 - Unauthorized

Authentication failed:

{
  "error": "Unauthorized"
}

500 - Internal Server Error

Server error occurred:

{
  "error": "Internal server error. Please try again later."
}