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://agent.fixr.nexus

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 (Base)
Pay $0.01 USDC per call on Base - no staking required
X-Payment-TxHash: 0xTransactionHash
x402 Payment (Solana)
Pay $0.01 USDC per call on Solana - no staking required
X-Payment-Chain: solana
X-Payment-TxHash: YourSolanaSignature

x402 Pay-Per-Call

Pay $0.01 USDC on Base or Solana to access premium endpoints. Each transaction is single-use.

1
Request API
2
Get 402
3
Send USDC
4
Retry + TxHash
5
Success

Base (EVM)

Parameter Value
Token USDC on Base (Chain ID 8453)
USDC Address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Recipient 0xBe2Cc1861341F3b058A3307385BEBa84167b3fa4
Amount 10000 (0.01 USDC, 6 decimals)
Header X-Payment-TxHash: 0x...

Solana

Parameter Value
Token USDC on Solana (mainnet-beta)
USDC Mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Recipient 96vRDBvjR2FhtzH5WtawLWdLh1dFmZjnY4DEsmjaEvuU
Amount 10000 (0.01 USDC, 6 decimals)
Headers X-Payment-Chain: solana + X-Payment-TxHash: <sig>

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": {
    "version": 2,
    "pricePerCall": "$0.01 USDC",
    "chains": {
      "base": { "token": "0x833589...", "recipient": "0xBe2Cc..." },
      "solana": { "mint": "EPjFWdd5...", "recipient": "96vRDB..." }
    },
    "headers": { "payment": "X-Payment-TxHash", "chain": "X-Payment-Chain" }
  }
}
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

Base (EVM)

Contract Address
FixrStaking 0x39DbBa2CdAF7F668816957B023cbee1841373F5b
FixrFeeSplitter 0x5bE1B904ce0Efbb2CC963aFd6E976f8F93AdC928
Treasury 0xBe2Cc1861341F3b058A3307385BEBa84167b3fa4
USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Solana

Account Address
Treasury 96vRDBvjR2FhtzH5WtawLWdLh1dFmZjnY4DEsmjaEvuU
USDC Mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v