Home Farcaster

API Documentation

Integrate with Fixr's API for token analysis, builder tracking, security audits, and more. Access is tiered by FIXR staking or pay-per-call via x402.

Base URL: https://fixr-agent.see21289.workers.dev

⚡ Access Tiers

Free
0
10 req/min
Builder
1M+
20 req/min
Pro
10M+
50 req/min
Elite
50M+
Unlimited

Stake FIXR tokens to unlock higher rate limits. Or pay $0.01 USDC per call via x402.

🔐 Authentication

📍 Wallet Header
Simple - just pass your wallet address
X-Wallet-Address: 0xYourWalletAddress
💳 x402 Payment
Pay $0.01 USDC per call - no staking required
X-Payment-TxHash: 0xTransactionHash

💰 x402 Pay-Per-Call

When rate limited, pay $0.01 USDC on Base to bypass. Each transaction is single-use.

1
Request API
2
Get 402
3
Send USDC
4
Retry + TxHash
5
Success ✓
Parameter Value
Token USDC on Base
Address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Recipient 0xBe2Cc1861341F3b058A3307385BEBa84167b3fa4
Amount 10000 (0.01 USDC, 6 decimals)

🛠 Endpoints

Token Analysis
POST /api/token/analyze Full token analysis
Request
POST /api/token/analyze
Content-Type: application/json

{ "address": "0xTokenAddress" }
Response
{
  "success": true,
  "analysis": {
    "token": { "name": "...", "symbol": "...", "totalSupply": "..." },
    "security": { "isHoneypot": false, "riskScore": 25 },
    "liquidity": { "usd": 150000, "locked": true },
    "holders": { "count": 1234, "topHolders": [...] }
  }
}
GET /api/token/honeypot/:address Quick honeypot check
Response
{
  "isHoneypot": false,
  "reason": null,
  "buyTax": 0,
  "sellTax": 5
}
GET /api/token/whales/:address Top token holders
Response
{
  "topHolders": [
    { "address": "0x...", "balance": "1000000", "percentage": 10.5 }
  ]
}
Builder Feed
GET /api/builders/casts Recent builder casts
Query Params
?category=shipped|insight|discussion
&limit=20
GET /api/builders/top Top builders by ships
Response
{
  "builders": [
    { "fid": 123, "username": "builder", "shipCount": 15 }
  ]
}
GET /api/builders/profile/:id Builder profile by FID/username
Response
{
  "fid": 123,
  "username": "builder",
  "displayName": "Builder Name",
  "ships": [...],
  "stats": { ... }
}
Access & Stats
GET /api/access/tier?wallet=0x... Check your staking tier
Response
{
  "success": true,
  "tier": "BUILDER",
  "stakedAmount": "1500000000000000000000000",
  "rateLimit": "20/min",
  "nextTier": { "tier": "PRO", "required": "10M FIXR" }
}
GET /api/access/payment Get x402 payment info
Response
{
  "x402": {
    "pricePerCall": "$0.01",
    "token": { "address": "0x833589...", "symbol": "USDC" },
    "recipient": "0xBe2Cc..."
  }
}
Security & Analysis (v1 API)
POST /api/v1/security/audit Smart contract security audit
Request
POST /api/v1/security/audit
Content-Type: application/json

{ "address": "0xContractAddress", "network": "base" }
Response
{
  "success": true,
  "audit": {
    "address": "0x...",
    "network": "base",
    "vulnerabilities": [...],
    "riskScore": 25,
    "suggestions": [...]
  }
}
POST /api/v1/wallet/intel Wallet intelligence & risk
Request
{ "address": "0xWalletAddress", "network": "base" }
Response
{
  "success": true,
  "wallet": "0x...",
  "intel": {
    "riskScore": 15,
    "deployerHistory": [...],
    "activityAnalysis": {...}
  }
}
GET /api/v1/rug/detect/:address Real-time rug detection
Response
{
  "success": true,
  "token": "0x...",
  "isRug": false,
  "riskLevel": "low",
  "indicators": [...]
}
GET /api/v1/sentiment/:symbol Farcaster sentiment analysis
Response
{
  "success": true,
  "symbol": "DEGEN",
  "sentiment": "bullish",
  "mentions": 156,
  "bankrMentions": {...}
}
Reputation Scores (v1 API)
GET /api/v1/reputation/ethos/:fid Ethos reputation score
Response
{
  "success": true,
  "fid": 2574393,
  "ethos": {
    "score": 85,
    "level": "high",
    "factors": [...]
  }
}
GET /api/v1/reputation/talent/:wallet Talent Protocol score
Response
{
  "success": true,
  "wallet": "0x...",
  "passport": {
    "score": 72,
    "credentials": [...]
  },
  "analysis": {...}
}
GET /api/v1/builder/:id Full builder profile
Response
{
  "success": true,
  "builder": {
    "fid": 123,
    "username": "builder",
    "ships": [...],
    "reputation": {...}
  }
}
AI Generation (v1 API)
POST /api/v1/generate/image AI image generation
Request
{ "prompt": "futuristic city", "style": "cyberpunk" }
Response
{
  "success": true,
  "imageUrl": "https://...",
  "mimeType": "image/png"
}
POST /api/v1/generate/video AI video generation
Request
{
  "prompt": "rocket launching into space",
  "duration": 5,
  "aspectRatio": "16:9"
}
Response
{
  "success": true,
  "taskId": "...",
  "status": "processing"
}
GitHub Analysis (v1 API)
POST /api/v1/github/analyze Repository analysis
Request
{ "owner": "the-fixr", "repo": "project", "branch": "main" }
Response
{
  "success": true,
  "repository": "the-fixr/project",
  "analysis": {
    "summary": "...",
    "issues": [...],
    "suggestions": [...]
  }
}

📜 Contracts

Contract Address
FixrStaking 0x39DbBa2CdAF7F668816957B023cbee1841373F5b
FixrFeeSplitter 0x5bE1B904ce0Efbb2CC963aFd6E976f8F93AdC928
Treasury 0xBe2Cc1861341F3b058A3307385BEBa84167b3fa4
USDC (Base) 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Built by Fixr · GitHub