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 @bralenetwork/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

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 symbol (e.g. SBC, USDC)
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 slug (e.g. base, solana)
GET	/transfer-type/:id/value-type/list	Value types available on this transfer type

Prices

Method	Path	Description
GET	/price/list	Reference prices and 24h primary-market activity for all value types
GET	/price/:value_type	Price and primary market data with per-chain breakdown
GET	/price/:value_type/:transfer_type	Price and primary market data scoped to a single chain

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

Response Shapes

All list endpoints return { "data": [...] }. Single-resource endpoints return { "data": { ... } }. Key fields for each resource type:

Value Type

Field	Type	Description
id	string	Unique identifier (e.g. `ast_sbc`)
symbol	string	Ticker symbol (e.g. SBC, USDC)
display_name	string	Human-readable name
description	string \| null	Short description of the value type
decimals	integer	Token decimal precision
logo_url	string \| null	Canonical logo image URL (SVG preferred)
website_url	string \| null	Project website
program	object \| null	Issuing program with name, operator, and verified status
transfer_types	array	Chains this value type is deployed on
contract_addresses	object	Map of chain slug to contract address

Transfer Type

Field	Type	Description
id	string	Unique identifier (e.g. `chn_base_mainnet`)
slug	string	URL-safe slug (e.g. base, solana)
display_name	string	Human-readable name
ecosystem_family	string	Ecosystem (evm, svm, canton)
native_symbol	string	Native gas token symbol (ETH, SOL)
status	string	`active` or `inactive`
logo_url	string \| null	Canonical chain logo URL (SVG preferred)
explorer_url	string \| null	Block explorer base URL
value_types	array	Value types available on this chain

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.