tokenbel.info

TokenBel AI API — read-only public data for Belarusian securities and NBRB FX rates. Important domain model: - Fields/parameters named uuid are TokenBel internal identifiers: opaque hexadecimal strings, usually 8 characters like 78c7e502. They are not RFC UUIDs and normally do not contain hyphens. Always pass the exact uuid value returned by search/list tools. - Tokens are TokenBel-native tokenized corporate securities on fintech platforms (fainex, finstore, bynex, whitebird). They do NOT have tickers. Use token_list/token_get_by_uuid; filter by platform/status. - Shares and bonds are BCSE exchange-listed securities. They DO have tickers and security_issuer rows. Use search_by_ticker first, then share_get_by_uuid/bond_get_by_uuid, share_payouts_get (shares only), or trading_stats_get. - Companies and securities issuers are different tables. search_by_name returns both and tags results with entity_type. For entity_type='company', use company_get_by_uuid. For entity_type='issuer', use uuid as issuer_uuid in share_list/bond_list. linked_company_uuid may connect an issuer to a company. company_financial_params_get accepts either a company id or an issuer id and returns financial statement metrics and ratios for the linked company. Resources: in addition to tools, this server exposes MCP resources under the tokenbel:// scheme. Use resources/list and resources/templates/list to discover available schema and entity resources. Schema resources (tokenbel://schemas/<name>) document entity and tool response contracts; read them to learn available fields and semantics before calling tools. Entity resources (tokenbel://tokens/{uuid}, tokenbel://shares/{uuid}, tokenbel://bonds/{uuid}, tokenbel://companies/{uuid}) fetch a single record by UUID via resources/read, returning the same output as the corresponding *_get_by_uuid tool. Recommended workflows: 1. Find share/bond: search_by_ticker(query) -> choose result.uuid exactly as returned -> share_get_by_uuid/bond_get_by_uuid. 2. Share dividends: search_by_ticker(query) -> choose share.uuid -> share_payouts_get(uuid). dividend_yield_pct is nominal-based, not market-price yield. 3. Trading stats (shares/bonds): search_by_ticker(query) -> trading_stats_get(uuid) for latest_30d, or pass date_from/date_to for a live range aggregate. 4. Company/issuer: search_by_name(name_or_unp) -> inspect entity_type before choosing next tool. 5. Company financial params: search_by_name(name_or_unp) -> choose company or issuer uuid exactly as returned -> company_financial_params_get(uuid) for periodic financial metrics and ratios. 6. Currency: currency_rate_get returns BYN per 1 unit of usd/eur/rub. 7. Token primary-market sales: token_list(platform/status) -> choose token.uuid -> token_trading_stats_get(uuid) for a per-day tokens-sold series (default last 30 days). 8. Company securities overview: search_by_name(name_or_unp) -> choose a company or issuer uuid -> company_tokens_list/company_shares_list/company_bonds_list(uuid) for trimmed summary cards of everything issued by that company (each accepts a company OR issuer uuid). 9. Entity news: search_by_name(name_or_unp) -> choose a company or issuer uuid -> entity_news_list(uuid) for published news events across the full entity graph (the company, its security issuers, their bonds/shares, and the company's tokens), filterable by event_types/impact_types and a date_from/date_to range. All tools are read-only and data is public/unauthenticated. Full documentation: https://tokenbel.info/.well-known/llms.txt