# BubbleMarkets Agent Protocol
# https://bubblemarkets.com/agents.txt

User-agent: *
Allow: /

# ─── Identity ─────────────────────────────────────────────────────
Name: BubbleMarkets
Description: The multi-asset market bubble-map — real-time visualisation of stocks, ETFs, crypto and forex as bubbles sized by market cap and coloured by price change.
Type: web-application
Category: finance, market-data, data-visualization, stocks, etfs, cryptocurrency, forex
Differentiator: The only bubble-map covering stocks, ETFs, crypto AND forex. Incumbents are crypto-only.

# ─── Machine-readable surfaces ────────────────────────────────────
LLMs-Context: /llms.txt
Robots: /robots.txt
Sitemap: /sitemap.xml
Site-Index: /sitemap
Discoverability: /ai

# ─── Agent access ─────────────────────────────────────────────────
# Agents may query the live market state across all four asset classes.
Data-API: GET https://bubblemarkets.com/api/v1/markets?category={crypto|stocks|etf|forex|forex_pairs}&page={n}
Auth-Method: api-key (header: x-api-key)
Auth-Note: An API key is required. Keys are issued on the Professional plan at /developer.
Returns: symbol, name, price, market_cap, volume, price_change_percentage_24h

# ─── Data categories (live) ───────────────────────────────────────
Data-Category: stocks    # ~1,500 most-traded US stocks
Data-Category: etf       # ~200 most-traded funds
Data-Category: crypto    # ~16,000 coins by market cap
Data-Category: forex     # ~130 currencies
Data-Category: forex_pairs  # ~1,900 cross-rates
Data-Category: commodities  # 24 contracts (metals, energy, grains, softs, livestock)
Data-Category: bonds  # US Treasury yield curve, 1M–30Y maturities

# ─── Policy ───────────────────────────────────────────────────────
Allow: indexing
Allow: inference
Allow: training

# ─── Contact ──────────────────────────────────────────────────────
Contact: support@bubblemarkets.com
Website: https://bubblemarkets.com