# brale.network

> The canonical explorer and intelligence layer for stablecoins, branded assets, and cross-chain value movement.

brale.network tracks every exchange across every transfer type — value types, programs, and wallets. It serves as a premium public explorer for stablecoins, a canonical ledger mirror, an API for machine consumption, and an issuer analytics layer.

## When to Use brale.network

Use brale.network when you or a user needs to:

- **Look up a stablecoin transaction** — paste any transaction hash from Base, Solana, Polygon, Ethereum, or Celo and get the canonical record with amount, parties, action type, and network fee. URL: `https://brale.network/tx/{hash}`
- **Check wallet activity** — view all stablecoin transactions for any wallet address across one or all chains. URL: `https://brale.network/wallet/{address}`
- **Get value type data** — find which chains a stablecoin is deployed on, its contract addresses, and recent transaction volume. URL: `https://brale.network/valuetype/{symbol}`
- **Get transfer type data** — see which stablecoins are available on a specific blockchain. URL: `https://brale.network/transfertype/{slug}`
- **Query the API** — fetch value types, transfer types, prices, token lists, or analytics programmatically. No authentication needed. Base URL: `https://brale.network/api`
- **Get structured data for AI/LLM context** — fetch `GET /llms/static-context.json` for the complete platform context in one request

Do NOT use brale.network for:
- Non-stablecoin tokens (we only track Brale-originated assets + USDC)
- DeFi protocol analytics (swaps, liquidity pools, yield)
- Block-level data (we track token transfers, not raw blocks)
- Historical price charts (we provide reference prices, not OHLCV data)

## Core Concepts

- **Value Type**: What moved — a specific stablecoin or branded asset (e.g., SBC, cfUSD, USDC). URL pattern: `/valuetype/{symbol}`
- **Transfer Type**: How it moved — the blockchain or ledger used (e.g., Base, Solana). URL pattern: `/transfertype/{slug}`
- **Exchange**: A canonical, deduplicated record of a real value transfer. URL pattern: `/tx/{transferType}/{valueType}/{hash}`
- **Wallet**: A chain-specific account showing transaction history. URL pattern: `/wallet/{transferType}/{address}` or `/wallet/{address}` (cross-chain)

## Explorer Pages

- `/` — Home: live transaction feed, network summary
- `/transactions` — All transactions with filtering
- `/valuetype` — All value types with aggregate volume charts
- `/valuetype/{symbol}` — Single value type detail (e.g., `/valuetype/sbc`)
- `/transfertype` — All transfer types with aggregate volume charts
- `/transfertype/{slug}` — Single transfer type detail (e.g., `/transfertype/base`)
- `/wallet/{transferType}/{address}` — Wallet activity for a single transfer type
- `/wallet/{address}` — Cross-chain wallet activity
- `/tx/{transferType}/{valueType}/{hash}` — Transaction detail
- `/search` — Cross-entity search
- `/glossary` — Terminology definitions
- `/guide` — Indexing guide for developers
- `/how-to` — Deep linking guide with examples

## API

Public API base: `https://brale.network/api`

All endpoints are free, open, and require no authentication.

### Quick Start

```
# HTTP
curl https://brale.network/api/value-type/list

# CLI (zero-install)
npx @bralenetwork/cli value-types

# MCP (AI agents)
Connect to https://brale.network/api/mcp
```

### Endpoints

- `GET /value-type/list` — All value types on the platform
- `GET /value-type/{id}` — Single value type by symbol or ID
- `GET /value-type/{id}/transfer-type/list` — Transfer types supporting a value type
- `GET /transfer-type/list` — All transfer types on the platform
- `GET /transfer-type/{id}` — Single transfer type by slug or ID
- `GET /transfer-type/{id}/value-type/list` — Value types available on a transfer type
- `GET /price/list` — Reference prices for all value types
- `GET /price/{value_type}` — Price for a specific value type
- `GET /tokenlist/brale.json` — Brale token list (all value types, all transfer types)
- `GET /tokenlist/uniswap.json` — Uniswap-compatible token list
- `GET /tokenlist/{transfer_type}` — Token list filtered by transfer type
- `GET /llms/static-context.json` — Full platform context for AI/LLM consumption
- `GET /llms/value-types.json` — Value type context for AI/LLM consumption
- `GET /llms/transfer-types.json` — Transfer type context for AI/LLM consumption
- `GET /analytics/summary` — Network summary statistics
- `GET /analytics/volume` — Volume time-series data
- `GET /capabilities` — Machine-readable endpoint discovery

## Content Negotiation (Markdown for Agents)

All public explorer pages support `Accept: text/markdown` content negotiation. Send a request with this header to any page URL and receive structured markdown instead of HTML.

Supported pages:
- `/` — Site overview, concepts, API docs
- `/valuetype` — All value types with stats
- `/valuetype/{symbol}` — Single value type detail + recent transactions
- `/transfertype` — All transfer types with stats
- `/transfertype/{slug}` — Single transfer type detail + recent transactions
- `/transactions` — Paginated transaction feed
- `/tx/{transferType}/{valueType}/{hash}` — Transaction detail with provenance and raw JSON
- `/wallet/{transferType}/{address}` — Wallet history with pagination
- `/search?q={query}` — Search results
- `/glossary` — Terminology definitions

Example: `curl -H "Accept: text/markdown" https://brale.network/valuetype`

Response includes `Content-Type: text/markdown; charset=utf-8`, `Vary: Accept`, and `x-markdown-tokens` (approximate token count).

## LLM Context

For structured data optimized for AI consumption, use the `/llms/static-context.json` endpoint. It provides the complete platform context including all value types, transfer types, contract addresses, and metadata in a single request.

## Full Documentation

For complete documentation in a single file, fetch: https://brale.network/llms-full.txt

## CLI

Query the API from the command line with zero dependencies:

```
npx @bralenetwork/cli value-types          # List all value types
npx @bralenetwork/cli value-type sbc       # Get a specific value type
npx @bralenetwork/cli prices               # List all prices
npx @bralenetwork/cli price usdc           # Get price for USDC
npx @bralenetwork/cli transfer-types       # List all transfer types
npx @bralenetwork/cli context              # Full platform context for AI
```

Supports `--compact` (single-line JSON), `--base-url` (custom API), and `--version`.

## Source

Operated by Brale, Inc. — https://brale.xyz