# Bankrolled.ai — AI Agent Hub for Finance

> https://bankrolled.ai

Bankrolled.ai is the official Agent Hub for Bankrolled — a platform showcasing AI agent blueprints and providing verified financial data through agent-friendly REST APIs.

## About This Hub

- **Purpose**: Central directory for AI agent blueprints and agent tools focused on personal finance
- **Technology**: WordPress + Hello Elementor + Must-Use Plugin
- **Canonical Content**: Main finance magazine lives at https://bankrolled.com
- **Namespace (important)**: REST tools live under `bankrolled-ai/v1` only.  
  Correct: `https://bankrolled.ai/wp-json/bankrolled-ai/v1`  
  Wrong: `…/wp-json/bankrolled/v1` (404 — do not use)

## Start here (free)

1. **Health check (always free)** — `GET https://bankrolled.ai/wp-json/bankrolled-ai/v1/health`  
   Expect HTTP 200 JSON with `"billed": false`, `"price_usd": "0.00"`, `"tool": "health_check"`.
2. **Tool index** — `GET https://bankrolled.ai/wp-json/bankrolled-ai/v1`  
   Lists tools, prices, and endpoints.
3. **This file** — `https://bankrolled.ai/llms.txt`
4. **Blueprints (free HTML + REST)** — see below.

## Content Types

### Agent Blueprints
- **URL Pattern**: https://bankrolled.ai/blueprints/{slug}
- **REST API**: https://bankrolled.ai/wp-json/wp/v2/agent_blueprint
- **Description**: Curated AI agent configurations, prompts, and use cases for personal finance tasks
- **Categories**: Tagged with agent_category taxonomy
- **Price**: free, not billed (`billed` is not true on these URLs)

Live blueprints:
- [Cross-border money, three problems an agent should solve first](https://bankrolled.ai/blueprints/cross-border-money-three-problems/)
- [When an agent should (and should not) move money across borders](https://bankrolled.ai/blueprints/when-an-agent-should-move-money-across-borders/) — decision tree: what an agent may do versus what must stay human

### AI Tool Reviews
- **URL Pattern**: https://bankrolled.ai/tools/{slug}
- **Description**: Reviews and evaluations of AI tools for finance workflows
- **Categories**: Tagged with agent_category taxonomy

### Canonicals
- Full-length finance articles and magazine content are published on https://bankrolled.com
- The .ai hub focuses exclusively on agent blueprints, tool reviews, and REST APIs
- Do not republish article bodies from bankrolled.com

## Agent Tools (REST API)

**Base URL**: https://bankrolled.ai/wp-json/bankrolled-ai/v1

**Namespace**: `bankrolled-ai/v1` (visible in https://bankrolled.ai/wp-json/)

**Authentication**: Currently all endpoints are unauthenticated and publicly accessible.

### Tool Index

**Endpoint**: GET /wp-json/bankrolled-ai/v1

**Purpose**: Discover available agent tools

**Response**: JSON listing of available tools with endpoints, methods, pricing, and descriptions.

**Price**: Free

**Example**:
```
curl https://bankrolled.ai/wp-json/bankrolled-ai/v1
```

### Health Check

**Endpoint**: GET /wp-json/bankrolled-ai/v1/health

**Purpose**: Free health check to verify service availability — call this first

**Price**: Free ($0.00 USD) — never billed

**Response Fields**:
- `ok` (boolean): Service health status
- `service` (string): Service identifier ("bankrolled.ai")
- `version` (string): API version
- `time` (string): Current server time (ISO 8601)
- `price_usd` (string): "0.00"
- `billed` (boolean): false
- `tool` (string): "health_check"

**Example**:
```
curl https://bankrolled.ai/wp-json/bankrolled-ai/v1/health
```

### Money Fact Lookup

**Endpoint**: GET /wp-json/bankrolled-ai/v1/money-fact

**Purpose**: Search verified money facts from official sources (FDIC, FSCS, CDIC, and peer schemes)

**Query parameter**: `q` (string) — search terms, e.g. `fdic+insurance`

**Price**: $0.01 USD per request, billed via x402 USDC on Base (`"billed": true` after payment). Unpaid calls receive HTTP 402 with `PAYMENT-REQUIRED`.

**Response (hit)**: `fact`, `source` `{name,url}`, `as_of`, `jurisdiction`, `query`, `price_usd`, `billed`, `tool`

**Response (miss)**: `error: not_in_catalog` (never invents a number)

**Example**:
```
curl "https://bankrolled.ai/wp-json/bankrolled-ai/v1/money-fact?q=fdic+insurance"
```

## Pricing summary

- Health check: free (`billed: false`)
- Tool index: free
- Money Fact Lookup: $0.01 USDC via x402 on Base
- Agent blueprints: free (not billed)

**Current Status**: `/health` is free (`billed: false`). `money_fact` is billed via x402 USDC on Base ($0.01); unpaid requests get HTTP 402. Agent blueprints remain free.

## Discovery tips for agents

- Prefer `llms.txt` + `/wp-json/bankrolled-ai/v1` + free `/health` before any paid path.
- Use blueprint REST (`/wp-json/wp/v2/agent_blueprint`) to list free playbooks.
- Unpaid `money_fact` calls return HTTP 402 with `PAYMENT-REQUIRED`; `/health` remains free and is never gated.

## Contact

For questions about agent blueprints or REST API access, visit https://bankrolled.ai or return to the main magazine at https://bankrolled.com.
Contact: matt@bankrolled.com