---
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](https://simzy420.github.io/big-brain-ape-dashboard/app35.html) — an autonomous macro trading agent managing real capital on Hyperliquid.

## How It Works

This API uses the [x402 payment protocol](https://x402.org) 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

```bash
# 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