# BuilderScout

> Builders conviction market DeFi primitive on Base. Lock $SCOUT on builders — early backers of improving builders profit.

BuilderScout is a conviction market on Base (ERC-20) where anyone can express conviction in onchain builders by locking $SCOUT. All locked SCOUT sits in a single global pool. Conviction units are priced by each builder's score ratio (normalizedScore / 100). When scores change, the pool redistributes zero-sum — improving builders gain pool share, declining builders lose it. Early, correct conviction is rewarded. Built by Zeno × Talent Protocol.

## How It Works

1. **Discover builders**: AI-powered scouting surfaces builders across GitHub, X, and onchain activity. Builders are scored via Builder Quality Index (archetypes: Full Stack, Code-First, Social Builder, Onchain Native, Emerging), Talent Radar predictions, and Talent Protocol reputation.
2. **Lock $SCOUT**: Choose a builder and lock $SCOUT. A 1% builder fee goes directly to the builder. The remaining 99% enters the global pool. You receive conviction units: `units = amountToPool / scoreRatio`.
3. **Scores change, value shifts**: Builder scores update periodically. The global pool auto-redistributes based on new score ratios. Zero-sum — improving builders gain at the expense of declining builders.
4. **Unlock and collect**: Sell conviction units at the current share price. 1% of the returned SCOUT is permanently burned (deflationary). No emissions, no inflation.

## Scoring & Composite

- **Composite score**: 55% conviction unit share + 45% Builder Intelligence Score
- **Builder Intelligence Score**: Blends BQI, Talent Radar, Talent Protocol score, and snapshot growth
- **Lock Activity Boost**: Up to +10 points (proportional to builder's % of global pool)
- **Holdings Boost**: Up to +5 points (logarithmic; `holdingsRef = max(1000, totalScoutLocked)`)
- **Score Ratio**: `max(0.01, normalizedScore / 100)`

## Fee Structure

- **Lock fee**: 1% builder fee on lock (paid to the builder as income)
- **Unlock fee**: 1% permanent burn on unlock (deflationary)
- No emissions, no new tokens minted

## Key Formulas

- `scoreRatio = max(0.01, normalizedScore / 100)`
- `units = amountToPool / scoreRatio`
- `totalCV = sum(units_i × scoreRatio_i)`
- `builderShare_i = (units_i × scoreRatio_i / totalCV) × pool`
- `sharePrice_i = builderShare_i / totalShares_i`
- `grossReturn = units × sharePrice`
- `netReturn = grossReturn × 0.99` (1% burned)

## Platform Features

- **Conviction Market**: Global pool, score-based pricing, zero-sum rebalancing, lock/unlock with fee flows
- **Builder Discovery**: AI scouting from X posts, Talent Protocol verification, Builder Quality Index archetypes
- **Talent Radar**: Predictive model (30/30/25/15 weights) identifying high-potential builders before the market
- **Builder Portal**: SIWE wallet auth, profile management, earnings tracking, AI advisor, activity analytics
- **Leaderboard**: Sortable builder ranking by score, price, 24h change, locked SCOUT, market cap, volume, backers
- **Snapshot Infrastructure**: Daily longitudinal data for trajectory analysis and growth trends
- **SCOUT Backing Campaign**: 100K non-withdrawable SCOUT per user (with Talent Protocol profile) for conviction market participation
- **Bankr Agent**: Natural language chat for wallet monitoring and token operations
- **Community Feed**: Posts, comments, likes, notifications

## $SCOUT Token

- Address: `0x8fe435d4F6900BbBe6b48431B91833f69BeaCba3`
- Chain: Base (ERC-20)
- Launch: Community-driven fair launch via Bankr with locked liquidity
- No private rounds, no pre-sales, no team allocations

## Links

- Website: https://builderscout.ai
- Whitepaper: https://builderscout.ai/whitepaper
- Market: https://builderscout.ai/market
- FAQ: https://builderscout.ai/faq
- How It Works: https://builderscout.ai/how-it-works
- X (Twitter): https://x.com/BuilderScout
- Bankr Agent: https://bankr.bot/agents/builderscout

## Read-Only API Endpoints (safe for LLMs to fetch)

These endpoints return public, read-only JSON. No authentication required.

- `GET https://builderscout.ai/api/builders` — list of public builder profiles. Returns: id, displayName, name, bio, imageUrl, mainWallet, humanCheckmark, walletVerified, builderCode, mainRole, rankPosition, score, twitterHandle, githubHandle, tags, discoveredAt, updatedAt. Supports `?hasTwitter=true`, `?hasGithub=true`, `?ranked=true`, `?minScore=N`, `?limit=N` (max 500), `?offset=N`, `?search=q`.
- `GET https://builderscout.ai/api/market/overview` — global conviction-pool overview (total locked SCOUT, total builders, total backers, top gainers/losers).
- `GET https://builderscout.ai/api/market/leaderboard` — sortable builder leaderboard ranked by score, locked SCOUT, market cap, volume, and 24h change.
- `GET https://builderscout.ai/api/market/builder/:id` — public builder market stats (locked SCOUT, conviction units, normalized score, price).
- `GET https://builderscout.ai/api/market/discover` — list of public builders with scores and archetypes.
- `GET https://builderscout.ai/api/market/history/:builderId` — historical normalized-score series for a builder.
- `GET https://builderscout.ai/api/market/ecosystem-snapshots` — periodic snapshots of the conviction-market ecosystem.
- `GET https://builderscout.ai/api/talent-radar` — Talent Radar predictive scores across all tracked builders.
- `GET https://builderscout.ai/api/talent-radar/:builderId` — Talent Radar assessment for one builder, including AI explanation.
- `GET https://builderscout.ai/api/scout-token` — $SCOUT token price, volume, liquidity (DexScreener-derived).
- `GET https://builderscout.ai/api/scout-token/summary` — concise $SCOUT summary card.
- `GET https://builderscout.ai/api/public/analytics-intelligence` — public analytics intelligence panel.
- `GET https://builderscout.ai/sitemap.xml` — full sitemap including one entry per active builder.

Other endpoints (including most write endpoints) require an authenticated session and are not intended for unattended LLM access. Please limit fetches to the read-only endpoints listed above.

## Contact

For partnerships, integrations, or builder inquiries, reach out via X @BuilderScout.