{"title":"Brale Stablecoin Data API - Help","description":"Public, machine-readable API for stablecoin metadata and prices issued or supported by Brale. No authentication required.","plugin_integration":{"description":"This API supports ChatGPT plugin integration and other LLM-based automation.","urls":{"plugin_manifest":"https://data.brale.xyz/.well-known/ai-plugin.json","openapi_spec":"https://data.brale.xyz/openapi.yaml","base_url":"https://data.brale.xyz"},"chatgpt_setup":{"instructions":"To use this API in ChatGPT:","steps":["1. Navigate to Plugin Store -> Develop your own plugin","2. Enter the base URL: https://data.brale.xyz","3. ChatGPT will auto-discover and register the plugin using the .well-known and OpenAPI files"],"note":"These endpoints are required by OpenAI-compatible plugins and follow standard plugin discovery protocols."},"compatibility":["ChatGPT Plugins","OpenAI GPTs","Claude (via OpenAPI spec)","Any LLM supporting OpenAPI 3.0","Custom agents and bots"]},"supported_tokens":{"SBC":{"name":"Stable Coin","description":"USD Backed Stablecoin","networks":["Ethereum","Base","Polygon","Arbitrum","Optimism","Celo","Avalanche","Solana"]},"USDGLO":{"name":"Glo Dollar","description":"Glo Dollar","networks":["Ethereum","Base","Polygon"]},"CFUSD":{"name":"Coinflow USD","description":"Coinflow USD","networks":["Base","Polygon"]},"USDC":{"name":"USD Coin","description":"Centre Consortium USD stablecoin","networks":["Ethereum","Base","Polygon","Arbitrum","Optimism","Avalanche"]}},"chain_id_reference":{"1":"Ethereum Mainnet","10":"Optimism","101":"Solana Mainnet","137":"Polygon","8453":"Base","42161":"Arbitrum One","42220":"Celo","43114":"Avalanche C-Chain","Stellar-Pubnet":"Stellar Network"},"endpoints":[{"method":"GET","path":"/price/{symbol}","url":"https://data.brale.xyz/price/{symbol}","summary":"Get current price (always $1.00) and metadata link for a stablecoin.","parameters":["symbol: sbc|usdglo|usdc (case-insensitive)"],"example":"https://data.brale.xyz/price/sbc","response_example":{"symbol":"SBC","name":"Stable Coin","price":"1.00","currency":"USD","details":"https://data.brale.xyz/data/sbc"}},{"method":"GET","path":"/data/{symbol}","url":"https://data.brale.xyz/data/{symbol}","summary":"Get complete metadata including contract addresses across all supported networks.","parameters":["symbol: sbc|usdglo|usdc (case-insensitive)"],"example":"https://data.brale.xyz/data/sbc","response_example":{"name":"Brale SBC Token List","tokens":[{"chainId":1,"address":"0xf9FB20B8E097904f0aB7d12e9DbeE88f2dcd0F16","name":"Stable Coin","symbol":"SBC","decimals":18},{"chainId":8453,"address":"0xfdcC3dd6671eaB0709A4C0f3F53De9a333d80798","name":"Stable Coin","symbol":"SBC","decimals":18}]}},{"method":"GET","path":"/list","url":"https://data.brale.xyz/list","summary":"List all available tokens with URLs for price and data endpoints.","example":"https://data.brale.xyz/list","response_example":{"tokens":[{"symbol":"SBC","name":"Stable Coin","urls":{"price":"https://data.brale.xyz/price/sbc","data":"https://data.brale.xyz/data/sbc"}}],"count":3}},{"method":"GET","path":"/help","url":"https://data.brale.xyz/help","summary":"This documentation endpoint with examples and usage guidance.","example":"https://data.brale.xyz/help"},{"method":"GET","path":"/get-started","url":"https://data.brale.xyz/get-started","summary":"Quick introduction and getting started guide for new users.","example":"https://data.brale.xyz/get-started"},{"method":"GET","path":"/openapi.yaml","url":"https://data.brale.xyz/openapi.yaml","summary":"OpenAPI 3.0 specification for this API.","example":"https://data.brale.xyz/openapi.yaml"},{"method":"GET","path":"/.well-known/ai-plugin.json","url":"https://data.brale.xyz/.well-known/ai-plugin.json","summary":"Plugin manifest for LLM integration following OpenAI plugin spec.","example":"https://data.brale.xyz/.well-known/ai-plugin.json"},{"method":"GET","path":"/version","url":"https://data.brale.xyz/version","summary":"API version information and release notes.","example":"https://data.brale.xyz/version"}],"llm_usage_guide":{"common_queries":[{"query":"What is the current price of SBC?","endpoint":"/price/sbc","response":"Returns price object with $1.00 USD (stablecoins maintain $1 peg)"},{"query":"Show me the contract address for USDGLO on Base","endpoint":"/data/usdglo","instructions":"Look for token with chainId: 8453 and return the address field"},{"query":"What networks support USDC?","endpoint":"/data/usdc","instructions":"List all unique chainId values and map to network names using chain_id_reference"},{"query":"List all available stablecoins","endpoint":"/list","response":"Returns array of all supported tokens with names and endpoint URLs"},{"query":"Get SBC contract address on Ethereum","endpoint":"/data/sbc","instructions":"Find token with chainId: 1 and return the address field"},{"query":"What is the decimal precision for SBC on Polygon?","endpoint":"/data/sbc","instructions":"Find token with chainId: 137 and return the decimals field (typically 18)"}],"best_practices":["Always specify which network when asking about contract addresses","Use chain IDs to identify networks: 1=Ethereum, 8453=Base, 137=Polygon, etc.","Token symbols are case-insensitive (sbc, SBC, Sbc all work)","Use /list first to discover available tokens","Use /data/{symbol} for complete metadata including all network deployments"]},"example_llm_queries":["What is the current price of SBC?","Show me the contract address for USDGLO on Base","What networks support USDC?","List all available stablecoins","What is the issuer of SBC?","Get SBC contract address on Ethereum","Which stablecoins are available on Polygon?","Show me all USDGLO deployments","What is the decimal precision for SBC?","How many networks does USDC support?"],"api_features":["No authentication required","CORS enabled for web apps","JSON responses only","Case-insensitive token symbols","Real-time data from GitHub source","OpenAPI 3.0 specification","LLM/ChatGPT plugin compatible","Environment-agnostic URLs"],"support":{"contact_email":"support@brale.xyz","legal_url":"https://brale.xyz/legal","documentation":"https://data.brale.xyz/openapi.yaml","plugin_manifest":"https://data.brale.xyz/.well-known/ai-plugin.json"},"contribute":{"title":"Add Your Stablecoin to This API","description":"Want to see your stablecoin listed in this API? You can submit a pull request to include it.","requirements":["Must be issued by Brale, or","Must be supported on Brale exchange"],"process":["1. Create a JSON file following the Uniswap Token List specification","2. Submit a pull request to the Brale commons repository","3. Include contract addresses for all supported networks","4. Ensure token metadata is accurate and complete"],"repository":"https://github.com/Brale-xyz/commons/tree/main/Data","instructions":"Submit your token data as a PR to the above repository. If your token meets the criteria and the PR is accepted, it will automatically appear in this API.","contact":"For questions about token listing criteria, contact support@brale.xyz"}}