Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/get-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Use our API to add reputation-based context and authentication to your app, like
2. Explore our [API Reference](/docs/talent-api/api-reference)
3. Jump into specific guides:
- [Authentication](/docs/talent-api/authentication)
- [Builder Score](/docs/talent-api/api-reference/get-a-specific-score-using-wallet-scorer-slug-talent-id-or-account-identifier)
- [Builder Rank](/docs/talent-api/api-reference/get-a-specific-score-using-wallet-scorer-slug-talent-id-or-account-identifier)
- [Credentials](/docs/talent-api/api-reference/get-the-score-and-the-credentials-using-wallet-scorer-slug-talent-id-or-account-identifier)

## Core Concepts
Expand All @@ -42,7 +42,7 @@ Talent is built around the following core concepts to create a comprehensive rep
- [**Account**](/docs/protocol-concepts/account): A connection to a third-party data source (wallet, GitHub, X, etc.) that provides reputation data.
- [**Data Point**](/docs/protocol-concepts/data-point): A specific verified fact about a builder (GitHub stars, wallet transactions, etc.).
- [**Events**](/docs/protocol-concepts/event): Historical records of reputation changes
- [**Score**](/docs/protocol-concepts/scoring-systems): A numerical measure of reputation calculated from Data Points using a specific Scoring System.
- [**Ranking Systems**](/docs/protocol-concepts/ranking-systems): A ranking system that evaluates reputation based on Data Points. Builder Rank is our primary ranking system for identifying top builders.

## Support

Expand Down
2 changes: 1 addition & 1 deletion docs/legal/creator-rewards-terms-conditions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Top 200 creators share the reward pool, proportionally to their Creator Score.

## 5. Evaluation Criteria

For more information about Creator Score please visit [this page](https://docs.talentprotocol.com/docs/protocol-concepts/scoring-systems/creator-score).
For more information about Creator Score please visit [this page](https://docs.talentprotocol.com/docs/protocol-concepts/ranking-systems/creator-score).

The specific weights and formulas used to calculate rankings are proprietary and subject to change at the sole discretion of Talent.

Expand Down
6 changes: 3 additions & 3 deletions docs/protocol-concepts/account.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,16 @@ An Account represents a connection with a third-party data provider.

An **Account** represents a connection with a third-party entity (e.g., Wallet Address, GitHub, X, LinkedIn) that feeds reputation data into Talent. Accounts can exist independently or be linked to a user.

A [**User**](/docs/protocol-concepts/user) represents an individual that signed up on talentprotocol.com to verify their reputation data and increase their [Builder Score](/docs/protocol-concepts/scoring-systems/builder-score), by connecting multiple [**accounts**](/docs/protocol-concepts/account)**.**
A [**User**](/docs/protocol-concepts/user) represents an individual that signed up on talentprotocol.com to verify their reputation data and improve their [Builder Rank](/docs/protocol-concepts/ranking-systems/builder-rank), by connecting multiple [**accounts**](/docs/protocol-concepts/account)**.**

## Key Attributes:

- **Accounts** have Account IDs (previously known as Passport ID) and account-specific URLs (until they're linked to a user), following this format:
- `talentprotocol.com/address/0xbd…23d4`
- `talentprotocol.com/github/filmacedo`
- If linked to a user, the account URL will automatically redirect to the user’s profile URL. Otherwise, it will show the data from that imported account independently.
- Once linked to a user, an account loses its independent profile and redirect to the users profile. The account also loses its [Builder Score](/docs/protocol-concepts/scoring-systems/builder-score), and its data feeds into the users aggregated reputation.
- Accounts display their own [Builder Score](/docs/protocol-concepts/scoring-systems/builder-score) unless linked to a user, at which point their data integrates into the users aggregated [Builder Score](/docs/protocol-concepts/scoring-systems/builder-score).
- Once linked to a user, an account loses its independent profile and redirect to the user's profile. The account also loses its [Builder Rank](/docs/protocol-concepts/ranking-systems/builder-rank), and its data feeds into the user's aggregated reputation.
- Accounts display their own [Builder Rank](/docs/protocol-concepts/ranking-systems/builder-rank) unless linked to a user, at which point their data integrates into the user's aggregated [Builder Rank](/docs/protocol-concepts/ranking-systems/builder-rank).
- Users can claim an imported account by verifying ownership (e.g., signing a wallet message, connecting GitHub).

## Types of Accounts:
Expand Down
2 changes: 1 addition & 1 deletion docs/protocol-concepts/data-point.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app

## Scoring Tags

- We use a **tag-based system** that determines how data points are used in [Scoring Systems](/docs/protocol-concepts/scoring-systems):
- We use a **tag-based system** that determines how data points are used in [Ranking Systems](/docs/protocol-concepts/ranking-systems):
- Initial tags: `human`, `builder`, `creator`
- Data points can have multiple tags
- Scoring systems use tags to determine which data points to include
2 changes: 1 addition & 1 deletion docs/protocol-concepts/event.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 5

An Event is a historical record of changes to a user’s reputation data over time.

Events track how reputation changes over time, giving users better insights into their progress. Think of it like Etherscan for the Builder Score: users will be able to see not just their current reputation state, but the complete history of how they got there.
Events track how reputation changes over time, giving users better insights into their progress. Think of it like Etherscan for Builder Rank: users will be able to see not just their current reputation state, but the complete history of how they got there.

Every change to reputation data is recorded as an Event with its old value, new value, and timestamp.

Expand Down
2 changes: 1 addition & 1 deletion docs/protocol-concepts/profile.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ The [API](/docs/talent-api/api-reference) provides advanced search capabilities
- Identity information (names, ENS domains, usernames)
- Connected accounts (GitHub, wallet addresses, etc.)
- Human verification status
- Builder Score values and score credentials
- Builder Rank values and ranking credentials
- Tags and interests

See the [API Reference](/docs/talent-api/api-reference) for detailed examples of profile search queries.
4 changes: 4 additions & 0 deletions docs/protocol-concepts/ranking-systems/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Ranking Systems",
"position": 7
}
22 changes: 22 additions & 0 deletions docs/protocol-concepts/ranking-systems/_creator-score.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Creator Score

The Creator Score is a scoring system available through the Talent API that evaluates content creation activity and creative contributions.

## Overview

Creator Score is one of several scoring systems available in the Talent Protocol ecosystem. It provides a numerical representation of a user's creative activity based on verified data from connected platforms and accounts.

The score takes into account various aspects of content creation, including:

- **Creation activity**: Content publishing frequency and consistency
- **Engagement metrics**: Audience size and interaction across platforms
- **Economic signals**: Monetization and earnings from creative work

## Accessing Creator Score Data

Creator Score data is available through the Talent API:

- **[Advanced Search endpoint](/docs/talent-api/api-reference/search-for-profiles)**: Filter and search profiles with Creator Score data
- **[Score endpoint](/docs/talent-api/api-reference/get-a-specific-score-using-wallet-scorer-slug-talent-id-or-account-identifier)**: Retrieve specific scoring information for profiles

For more information about the Talent API and how to access scoring data, see the [API Reference](/docs/talent-api/api-reference).
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"label": "Builder Rank"
}
39 changes: 39 additions & 0 deletions docs/protocol-concepts/ranking-systems/builder-rank/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Builder Rank

A ranking system to recognize real onchain builders.

## What is Builder Rank?

Builder Rank is a ranking system that represents a user's position relative to other builders, based on verified activity and impact.

Builder Rank aims to distinguish builders from other types of crypto users, by valuing both the quantity and quality of their contributions. It reflects both "potential" (future growth) and "achievements" (proven track record).

Users can leverage their Builder Rank within Talent's growing partner ecosystem, while developers can easily add Builder Rank to their apps.

Apps like [Basenames](https://x.com/TalentProtocol/status/1825995151275434439) or [Etherscan](https://x.com/TalentProtocol/status/1830974248363622607) already integrate with Builder Rank to bring more context to their users and to curate the best builders in crypto.

## How Builder Rank Works

Builder Rank is determined by your position relative to other builders. It is calculated from verified [Data Points](/docs/protocol-concepts/data-point) collected from your connected accounts, such as:

- GitHub contributions and repositories
- Onchain transactions and contract deployments
- Hackathon participation and wins
- Social presence (Farcaster, Twitter/X)

Each Data Point is evaluated based on how strongly it signals real building activity. The exact formula is not disclosed to prevent gaming.

:::warning

Builder Rank is still experimental, so expect regular updates to the ranking algorithm.

:::

## Accessing Builder Rank

You can retrieve a builder's rank via the Talent API:

- [**Rank endpoint**](/docs/talent-api/api-reference/get-a-specific-score-using-wallet-scorer-slug-talent-id-or-account-identifier): Get a builder's rank by wallet address, Talent ID, or account identifier
- [**Profile search**](/docs/talent-api/api-reference/search-for-profiles): Search and filter profiles by rank

Builder Rank doesn't have a maximum cap, so rankings evolve over time as more builders join and more data sources are added.
20 changes: 20 additions & 0 deletions docs/protocol-concepts/ranking-systems/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Ranking Systems

A Ranking System evaluates verified [Data Points](/docs/protocol-concepts/data-point) to determine a user's position relative to others in a specific domain.

Under the hood, each ranking system uses an internal scoring algorithm to convert Data Points into a final rank. The scores themselves are not exposed — only the resulting rank is made available through the API.

Talent intentionally separates Data Points (objective data) from Ranking Systems (subjective evaluation). Both are autonomous and composable protocol primitives.

## Available Ranking Systems

Multiple ranking systems can exist in parallel, each designed to evaluate talent in a specific domain:

- [Builder Rank](/docs/protocol-concepts/ranking-systems/builder-rank) identifies and ranks people creating software
- Other ranking systems coming soon

Each ranking system operates independently with its own set of relevant Data Points, tailored to what matters for their specific persona.

This modular approach allows Talent to serve different communities with metrics that genuinely reflect their unique contributions, rather than forcing diverse talents into the same box.

Reach out if you want to create a custom ranking system.
2 changes: 1 addition & 1 deletion docs/protocol-concepts/scoring-systems/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Scoring Systems",
"label": "Ranking Systems",
"position": 7
}

This file was deleted.

This file was deleted.

109 changes: 0 additions & 109 deletions docs/protocol-concepts/scoring-systems/builder-score/index.mdx

This file was deleted.

Loading