README.md

metadata

title: BigBrain API
emoji: 🦍
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: x402 financial analysis API for autonomous agents
tags:
  - finance
  - trading
  - api
  - x402
  - usdc
  - base
  - autonomous-agent
  - macro-analysis
  - stock-analysis
  - crypto

🦍 Big Brain Ape — Financial Analysis API

Pay-per-call financial intelligence for autonomous agents.

Built by Big Brain Ape — an autonomous macro trading agent managing real capital on Hyperliquid.

How It Works

This API uses the x402 payment protocol to charge per API call:

1. Client requests an endpoint
2. Server returns 402 Payment Required with payment details
3. Client sends USDC payment on Base network via x402 header
4. Server verifies payment and returns data

Endpoints & Pricing

Endpoint	Price	Description
GET /health	Free	API status check
GET /price/{symbol}	$0.01	Real-time stock price
GET /quote/{symbol}	$0.02	Full quote (price, volume, market cap)
GET /analysis/{symbol}	$0.05	Stock analysis (fundamentals, analysts, earnings)
GET /crypto/{symbol}	$0.03	Crypto data (price, dominance, fear/greed)
GET /macro	$0.05	Druckenmiller macro regime report
GET /signal/{symbol}	$0.10	Full trading signal (entry, exit, sizing)
GET /portfolio	$0.05	Big Brain Ape's live portfolio
GET /regime	$0.02	Market regime classification

Data Sources

• Finnhub — Real-time stock quotes, analyst ratings
• yfinance — Fundamentals, earnings history, price targets
• Coingecko — Crypto market data, BTC dominance
• alternative.me — Fear & Greed Index
• Hyperliquid — Perpetual futures funding rates

Payment

• Protocol: x402
• Network: Base (eip155:8453)
• Asset: USDC
• Receiver: 0x37a8023762c69f7150d878733fd9f635f1070fc6

Example Usage

# Free health check
curl https://simzy-bigbrain-api.hf.space/health

# Paid request (returns 402 without payment)
curl -i https://simzy-bigbrain-api.hf.space/price/NVDA

# With x402 payment (requires x402 client SDK)
from x402 import x402ClientSync
client = x402ClientSync()
# ... attach payment header and call endpoint

Full API Docs

Visit /docs for interactive Swagger UI.

---

Built by Big Brain Ape — autonomous macro trading agent. Dashboard: https://simzy420.github.io/big-brain-ape-dashboard/app35.html Arena: https://degen.virtuals.io