Brale Network API

The Network API enables you to view information about value types and transfer types tracked by our services.

Getting Started

The Brale Network API is free and open — no API keys, no signup, no authentication. Choose how you want to integrate:

Option 1: curl / HTTP

Start querying immediately from any language or tool:

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

Option 2: MCP (AI Agents)

Point your MCP client (Claude, ChatGPT, Cursor) at the server:

MCP endpoint: https://brale.network/api/mcp

Option 3: CLI

Query from the command line with zero setup:

npx @brale/cli value-types

Option 4: OpenAPI SDK Generation

Generate a typed client in any language from the OpenAPI 3.1 spec:

npx openapi-typescript https://brale.network/api/openapi.json -o brale.d.ts

Pricing

Tier	Price	Rate Limit	Features
Free	$0/month	120 req/min	All endpoints, MCP, OpenAPI, token lists, LLM context, analytics
Premium	Coming soon	Higher limits	Historical analytics, webhook subscriptions, dedicated support

No signup required for the Free tier — start using the API immediately. For premium access or enterprise needs, contact api@brale.xyz. Full pricing details: /pricing.md.

Base URL

https://brale.network/api

No authentication required. All endpoints are free and open.

Endpoints

Value Types

Method	Path	Description
GET	/value-type/list	List all value types
GET	/value-type/:id	Single value type by ID or symbol
GET	/value-type/:id/transfer-type/list	Transfer types that carry this value type

Transfer Types

Method	Path	Description
GET	/transfer-type/list	List all transfer types
GET	/transfer-type/:id	Single transfer type by ID or slug
GET	/transfer-type/:id/value-type/list	Value types available on this transfer type

Prices

Method	Path	Description
GET	/price/list	Reference prices for all value types
GET	/price/:value_type	Price by symbol or ID

Token List

Method	Path	Description
GET	/tokenlist/brale.json	All value type deployments
GET	/tokenlist/uniswap.json	EVM-only deployments
GET	/tokenlist/:transfer_type	Per-transfer type list

LLM Context

Method	Path	Description
GET	/llms/value-types.json	Value types as structured AI context
GET	/llms/transfer-types.json	Transfer types as structured AI context
GET	/llms/static-context.json	Complete value layer context

Examples

List all value types

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

Get SBC and its transfer types

Returns SBC with every transfer type it's deployed on and each contract address.

curl https://brale.network/api/value-type/sbc

Which value types are on Base?

curl https://brale.network/api/transfer-type/base/value-type/list

Get the price of rUSD

curl https://brale.network/api/price/rusd

Value types on Solana

Returns all value type deployments on Solana in Uniswap Token List format.

curl https://brale.network/api/tokenlist/solana

AI context for the full value layer

Structured context describing all value types, transfer types, and contract addresses. Feed this to an LLM.

curl https://brale.network/api/llms/static-context.json

Error Handling

All errors return a consistent JSON structure:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Value type 'xyz' not found"
  },
  "status": 404
}

Error Codes

Code	HTTP Status	Meaning
NOT_FOUND	404	The requested resource does not exist. Check the ID or symbol.
VALIDATION_ERROR	400	Invalid request parameters.
RATE_LIMITED	429	Rate limit exceeded. Wait and retry after the Retry-After period.
INTERNAL_ERROR	500	Unexpected server error. Retry after a brief delay.

Rate Limits

Every response includes rate limit headers. The default limit is 120 requests per minute per IP address.

Header	Description
X-RateLimit-Limit	Maximum requests per window (120)
X-RateLimit-Remaining	Requests remaining in current window
X-RateLimit-Reset	Unix timestamp when the window resets
Retry-After	Seconds to wait (only on 429 responses)

When rate limited, back off for the number of seconds in the Retry-After header. Do not retry immediately — exponential backoff is recommended.

For AI Agents

The Brale Network API is designed to be consumed by AI agents without any authentication barrier. There are no API keys, OAuth tokens, or session cookies. Every endpoint is open and free.

MCP Server

An MCP (Model Context Protocol) server is available at https://brale.network/api/mcp. It supports the Streamable HTTP transport and exposes all API endpoints as callable tools. Point your MCP client (Claude, ChatGPT, Cursor) to https://brale.network/api/mcp.

OpenAPI Spec

A machine-readable OpenAPI 3.1.0 specification is available at https://brale.network/api/openapi.json. Use it with function-calling LLMs, code generators, or SDK builders.

Content Negotiation

All explorer pages support Accept: text/markdown content negotiation. Agents that prefer markdown over HTML can request structured markdown from any page:

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

Discovery Files

URL	Purpose
/llms.txt	LLM-optimized site description
/llms-full.txt	Complete documentation in one file
/.well-known/mcp/server-card.json	MCP server capabilities
/.well-known/agent-card.json	A2A agent card
/.well-known/ai-plugin.json	OpenAI plugin manifest
/?mode=agent	Structured JSON overview for agents

Error Recovery for Agents

All errors return structured JSON with a code field. Agents should:

On NOT_FOUND (404): Check the ID/symbol. Use /value-type/list to enumerate valid IDs.
On RATE_LIMITED (429): Wait for Retry-After seconds, then retry.
On INTERNAL_ERROR (500): Retry once after 2-5 seconds. If persistent, the service may be temporarily unavailable.