TokenBel Financial Data
REMOTE · MCP.TOKENBEL.INFO · SCANNED AUG 3
Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security63
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 19 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability80
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5039 tokens (~179/item across 28 items; 19 tools + 9 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · mcp.tokenbel.info
claude mcp add --transport http andreidrang-tokenbel-mcp https://mcp.tokenbel.info/mcp
[mcp_servers.andreidrang-tokenbel-mcp] url = "https://mcp.tokenbel.info/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"andreidrang-tokenbel-mcp": {
"type": "remote",
"url": "https://mcp.tokenbel.info/mcp",
"enabled": true
}
}
} openclaw mcp add andreidrang-tokenbel-mcp --url https://mcp.tokenbel.info/mcp --transport streamable-http
mcp_servers:
andreidrang-tokenbel-mcp:
url: "https://mcp.tokenbel.info/mcp" {
"mcpServers": {
"andreidrang-tokenbel-mcp": {
"type": "http",
"url": "https://mcp.tokenbel.info/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 66
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://mcp.tokenbel.info/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=tokenbel.info | CN=WE1,O=Google Trust Services,C=US | 9 Jun 2026 | 7 Sept 2026 | ECDSA 256 | ECDSA-SHA256 | acd918dbafa629b60e8b548369b41cf9 |
| SANs: tokenbel.info, mcp.tokenbel.info, *.mcp.tokenbel.info | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC insecure
Validation of mcp.tokenbel.info. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| info. | present | 5104 | 8 | Verified |
| tokenbel.info. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=0; includeSubDomains; preload |
| x-content-type-options | nosniff |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.tokenbel.info/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.tokenbel.info/mcp | HTTPS enforced | 301 | https://mcp.tokenbel.info/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
bond_get_by_uuid ~155
Get a single BCSE exchange-listed bond by its TokenBel internal identifier (field name: uuid). Returns ticker, issuer_uuid/issuer_name, bond_kind, current coupon/annual yield rate, payment type, maturity date, and is_trading (traded today). Use search_by_ticker first when starting from a ticker. Trading history is available via trading_stats_get; no separate bond payout schedule is exposed by this worker.
| Name | Type | Req | Description |
|---|---|---|---|
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Bond id, usually di… |
| Name | Type | Req | Description |
|---|---|---|---|
| admission_date | — | yes | — |
| bond_kind | — | yes | — |
| created_at | string | yes | — |
| currency | — | yes | — |
| is_active | boolean | yes | — |
| is_trading | — | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| maturity_date | — | yes | — |
| name | — | yes | — |
| nominal_value | — | yes | — |
| percent_payment_type | — | yes | — |
| percent_rate | — | yes | — |
| security_kind | string | yes | — |
| ticker | — | yes | — |
| updated_at | string | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
bond_list ~243
List active BCSE exchange-listed bonds with optional filtering by securities issuer TokenBel internal id (parameter name: issuer_uuid) and today-trading flag. Use issuer_uuid from search_by_name results where entity_type="issuer". Supports cursor-based pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Pagination cursor datetime (ISO 8601) |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Pagination cursor i… |
| is_trading | boolean | — | Filter by is_traded_today flag: true means traded today, not historical liquidity |
| issuer_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Filter by security_… |
| limit | integer | — | Max results (1-1000, default 50) |
| Name | Type | Req | Description |
|---|---|---|---|
| bonds | array | yes | — |
| count | number | yes | — |
| next_cursor | — | yes | — |
No examples provided.
company_bonds_list ~217
List summary cards of a company's active bonds. Accepts a company OR issuer TokenBel id; resolves the company and returns its bonds.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together. |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Opaque cursor id pa… |
| limit | integer | — | Max results per page (default 50). |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer i… |
| Name | Type | Req | Description |
|---|---|---|---|
| bonds | array | yes | — |
| company_name | string | yes | — |
| company_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| count | number | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| limit | number | yes | — |
| next_cursor | — | yes | — |
| requested_entity_type | string | yes | — |
| requested_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
company_financial_params_get ~177
Get financial parameters for a company or securities issuer by TokenBel internal identifier (field name: uuid). Returns periodic financial statement metrics (balance, equity, long/short-term assets and liabilities) and calculated financial ratios (liquidity, leverage, independence, stability, capitalization). Accepts a company id or an issuer id — issuer ids are resolved to their linked company. Find the id via search_by_name first.
| Name | Type | Req | Description |
|---|---|---|---|
| limit_periods | integer | — | Max number of periods to return (newest first). Default 8. |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer i… |
| Name | Type | Req | Description |
|---|---|---|---|
| company_name | string | yes | — |
| company_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| count | number | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| periods | array | yes | — |
| requested_entity_type | string | yes | — |
| requested_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
company_get_by_uuid ~136
Get a single company catalogue row by its TokenBel internal identifier (field name: uuid). Returns name, full_name, UNP (Belarusian tax ID), industry, logo, and activity flag. Companies are not always the same row as securities issuers; use search_by_name to discover both companies and issuers.
| Name | Type | Req | Description |
|---|---|---|---|
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company id, usually… |
| Name | Type | Req | Description |
|---|---|---|---|
| address | — | yes | — |
| created_at | string | yes | — |
| full_name | — | yes | — |
| industry | — | yes | — |
| is_active | boolean | yes | — |
| logo_path | — | yes | — |
| name | string | yes | — |
| unp | — | yes | — |
| updated_at | string | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
company_list ~163
List active company catalogue rows with optional filtering by industry. This does not list security_issuer rows directly; use search_by_name to find issuers and then share_list/bond_list with issuer_uuid. Supports cursor-based pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Pagination cursor datetime (ISO 8601) |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Pagination cursor i… |
| industry | string | — | Filter by company_industry.name exact value |
| limit | integer | — | Max results (1-1000, default 50) |
| Name | Type | Req | Description |
|---|---|---|---|
| companies | array | yes | — |
| count | number | yes | — |
| next_cursor | — | yes | — |
No examples provided.
company_shares_list ~217
List summary cards of a company's active shares. Accepts a company OR issuer TokenBel id; resolves the company and returns its shares.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together. |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Opaque cursor id pa… |
| limit | integer | — | Max results per page (default 50). |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer i… |
| Name | Type | Req | Description |
|---|---|---|---|
| company_name | string | yes | — |
| company_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| count | number | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| limit | number | yes | — |
| next_cursor | — | yes | — |
| requested_entity_type | string | yes | — |
| requested_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| shares | array | yes | — |
No examples provided.
company_tokens_list ~219
List summary cards of a company's active tokens (emissions). Accepts a company OR issuer TokenBel id; resolves the company and returns its tokens.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together. |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Opaque cursor id pa… |
| limit | integer | — | Max results per page (default 50). |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer i… |
| Name | Type | Req | Description |
|---|---|---|---|
| company_name | string | yes | — |
| company_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| count | number | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| limit | number | yes | — |
| next_cursor | — | yes | — |
| requested_entity_type | string | yes | — |
| requested_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| tokens | array | yes | — |
No examples provided.
currency_rate_get ~252
Get NBRB (National Bank of Belarus) official FX rates against BYN (Belarusian ruble) for USD, EUR, and/or RUB. Rates are BYN per 1 unit of foreign currency. Modes: latest (no dates), single_date (date), range (date_from/date_to, either bound optional), or grouped weekly/monthly aggregates (group_by + range). Only usd/eur/rub are supported; BYN is the implicit base currency.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | — | Filter to one supported foreign currency: usd, eur, or rub. Omit to return all three. BYN is the base currency, not a target. |
| date | string | — | Single date in YYYY-MM-DD format. Mutually exclusive with date_from/date_to. |
| date_from | string | — | Range start date in YYYY-MM-DD format (inclusive). Can be omitted for open-start range. |
| date_to | string | — | Range end date in YYYY-MM-DD format (inclusive, >= date_from). Open-ended or today-bounded ranges bypass cache. |
| group_by | string | — | Aggregate by week or month. Requires a date range (date_from/date_to), not a single date. |
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | — |
| count | number | yes | — |
| currency | array | yes | — |
| date_from | — | yes | — |
| date_to | — | yes | — |
| group_by | string | — | — |
| mode | string | yes | — |
| results | array | yes | — |
No examples provided.
entity_news_list ~396
List full published news events across a company's or issuer's full entity graph (the company, its security_issuers, their bonds/shares, and emissions under the company). Accepts a company OR issuer TokenBel id; resolves the entity and returns enriched news events with aggregated links and tags. Supports filtering by event_types, impact_types, and a date_from/date_to range, plus cursor-based pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_event_id | string | — | Opaque pagination cursor part 1 (the last event id) from the next_cursor returned by a prior call; pass both cursor parts together. |
| cursor_published_at | string | — | Opaque pagination cursor part 2 (the last event sort-key timestamp) from the next_cursor returned by a prior call; pass both cursor parts together. |
| date_from | string | — | Optional inclusive lower bound on the event date (ISO YYYY-MM-DD). |
| date_to | string | — | Optional inclusive upper bound on the event date (ISO YYYY-MM-DD). |
| event_types | array | — | Optional filter on news_event.event_type. Valid values: company_news, share_event, bond_event, token_event, emission_event, corporate_action, payment_event, default_risk, financial_report, regulatory… |
| impact_types | array | — | Optional filter on news_event.impact_type. Valid values: positive, neutral, negative, mixed. Case-insensitive. |
| limit | integer | — | Max results per page (default 20, max 50). |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer i… |
| Name | Type | Req | Description |
|---|---|---|---|
| company_name | string | yes | — |
| company_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| count | number | yes | — |
| events | array | yes | — |
| filters | object | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| limit | number | yes | — |
| next_cursor | — | yes | — |
| requested_entity_type | string | yes | — |
| requested_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
search_by_name ~172
Search companies AND securities issuers by name, full name, or UNP (Belarusian tax ID). Results are tagged with entity_type: "company" (use company_get_by_uuid) or "issuer" (use uuid as issuer_uuid in share_list/bond_list). The returned uuid/issuer_uuid values are opaque TokenBel internal ids (usually 8 hex chars, not RFC UUIDs). Companies and issuers are different tables and may overlap; linked_company_uuid connects an issuer to a company when known.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Max results (1-100, default 20) |
| query | string | yes | Company/issuer name or UNP (Belarusian tax ID) search query; case-insensitive, e.g. 'bank' matches 'MTBank', 'Priorbank' |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| query | string | yes | — |
| results | array | yes | — |
No examples provided.
search_by_ticker ~165
Search BCSE exchange-listed shares and bonds by ticker (case-insensitive substring match). Tokens are excluded because they do not have ticker symbols. Use the returned uuid value as an opaque TokenBel internal id (usually 8 hex chars, not an RFC UUID) with share_get_by_uuid/bond_get_by_uuid, share_payouts_get for share rows, or trading_stats_get for either share/bond row. Returns entity_type, ticker, issuer_uuid, issuer_name, and is_trading (traded today).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Max results (1-100, default 20) |
| query | string | yes | Ticker search query for listed shares/bonds only (case-insensitive substring, e.g. 'MTB' matches 'MTBank') |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| query | string | yes | — |
| results | array | yes | — |
No examples provided.
share_get_by_uuid ~136
Get a single BCSE exchange-listed share by its TokenBel internal identifier (field name: uuid). Returns ticker, issuer_uuid/issuer_name, share_kind (common/preferred), nominal value, lot size, and is_trading (traded today, not historical liquidity). Use search_by_ticker first when starting from a ticker.
| Name | Type | Req | Description |
|---|---|---|---|
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Share id, usually d… |
| Name | Type | Req | Description |
|---|---|---|---|
| admission_date | — | yes | — |
| created_at | string | yes | — |
| currency | — | yes | — |
| is_active | boolean | yes | — |
| is_trading | — | yes | — |
| issuer_name | — | yes | — |
| issuer_uuid | — | yes | — |
| lot_size | — | yes | — |
| name | — | yes | — |
| nominal_value | — | yes | — |
| security_kind | string | yes | — |
| share_kind | — | yes | — |
| ticker | — | yes | — |
| updated_at | string | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
share_list ~243
List active BCSE exchange-listed shares with optional filtering by securities issuer TokenBel internal id (parameter name: issuer_uuid) and today-trading flag. Use issuer_uuid from search_by_name results where entity_type="issuer". Supports cursor-based pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Pagination cursor datetime (ISO 8601) |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Pagination cursor i… |
| is_trading | boolean | — | Filter by is_traded_today flag: true means traded today, not historical liquidity |
| issuer_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Filter by security_… |
| limit | integer | — | Max results (1-1000, default 50) |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| next_cursor | — | yes | — |
| shares | array | yes | — |
No examples provided.
share_payouts_get ~191
Get dividend/payout history and an aggregate summary for a single share by its TokenBel internal identifier (field name: uuid). Use search_by_ticker to find a share, then call this tool with the returned uuid value. Event period_type is annual/halfyear/quarterly. Event status meanings: declared = payout declared/expected/paid depending on dates, no_dividend = issuer declared no payout, cancelled = revoked. Summary money totals use declared events only. dividend_yield_pct is a nominal-based proxy (latest declared amount / nominal value * 100), not a market-price dividend yield.
| Name | Type | Req | Description |
|---|---|---|---|
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Share id, usually d… |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | — | yes | — |
| events | array | yes | — |
| nominal_value | — | yes | — |
| share_uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| summary | object | yes | — |
| ticker | — | yes | — |
No examples provided.
token_get_by_uuid ~131
Get a single token by its TokenBel internal identifier (field name: uuid). Tokens are TokenBel-native tokenized corporate securities on fintech platforms (fainex/finstore/bynex/whitebird), not BCSE-listed tickers. Returns platform, lifecycle status, pricing, coupon rate, and company info.
| Name | Type | Req | Description |
|---|---|---|---|
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Token id, usually d… |
| Name | Type | Req | Description |
|---|---|---|---|
| company_name | — | yes | — |
| company_uuid | — | yes | — |
| created_at | string | yes | — |
| currency | string | yes | — |
| emission_stop | — | yes | — |
| is_active | boolean | yes | — |
| name | string | yes | — |
| percent_rate | — | yes | — |
| platform | string | yes | — |
| sold | — | yes | — |
| status | string | yes | — |
| token_price | — | yes | — |
| total_tokens | — | yes | — |
| updated_at | string | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
token_list ~243
List active tokens with optional filtering by fintech platform and token lifecycle status. Tokens do not have tickers; use this list tool to browse tokenized securities by platform/status. Supports cursor-based pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_created_at | string | — | Pagination cursor datetime (ISO 8601) |
| cursor_uuid | string | — | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Pagination cursor i… |
| limit | integer | — | Max results (1-1000, default 50) |
| platform | string | — | Filter by tokenization platform: fainex, finstore, bynex, or whitebird. |
| status | string | — | Filter by token lifecycle status: SELL_NOT_STARTED (sale not open yet), SELL_IN_PROGRESS (currently selling), SELL_SUSPENDED (sale paused), SOLD_OUT (fully sold), SELL_ENDED (sale ended), CIRCULATION… |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | — |
| next_cursor | — | yes | — |
| tokens | array | yes | — |
No examples provided.
token_trading_stats_get ~224
Get primary-market sales statistics for a token by its TokenBel internal identifier (field name: uuid). Returns a per-day series of tokens sold (derived from the cumulative instrument_log.sold counter), range totals, and a token snapshot (status, token_price, percent_rate, sold_total, total_tokens, sold_pct). Find the id via token_list first. Always a date range: omit both dates for the last 30 days, or provide date_from and/or date_to. Secondary-market data is not included.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | — | Range start date YYYY-MM-DD (inclusive). Defaults to date_to minus 30 days when omitted. |
| date_to | string | — | Range end date YYYY-MM-DD (inclusive, >= date_from). Defaults to today when omitted. |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Token id, usually d… |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | yes | — |
| daily | array | yes | — |
| mode | string | yes | — |
| period | object | yes | — |
| platform | string | yes | — |
| security_kind | string | yes | — |
| snapshot | object | yes | — |
| totals | object | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
No examples provided.
trading_stats_get ~312
Get trading statistics for a BCSE exchange-listed share or bond by TokenBel internal identifier (field name: uuid). Use search_by_ticker first. Modes: latest_30d (default, no dates) reads the refreshed 30-day materialized view and includes latest price/yield plus yield_wavg; range (both date_from and date_to, YYYY-MM-DD, inclusive) aggregates raw trade history live and returns yield_min/yield_max only — yield_wavg and all *_latest fields are null in range mode. Omit both dates or provide both; one bound is rejected. Both modes also return daily_series: one point per trade_date (same-day buckets collapsed across market_type/trade_mode/payment_code) with per-day turnover, transactions, price_wavg/min/max, and yield_min/max — no range-level rollup.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | string | — | Range start date YYYY-MM-DD (inclusive). Provide both date_from and date_to for range mode; omit both for latest_30d mode. |
| date_to | string | — | Range end date YYYY-MM-DD (inclusive, >= date_from). Provide both date_from and date_to for range mode; ranges ending today bypass cache. |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Listed share or bon… |
| Name | Type | Req | Description |
|---|---|---|---|
| daily_series | array | yes | — |
| last_trade_date | — | yes | — |
| mode | string | yes | — |
| period | object | yes | — |
| price_latest_date | — | yes | — |
| price_max | — | yes | — |
| price_min | — | yes | — |
| price_wavg | — | yes | — |
| price_wavg_latest | — | yes | — |
| security_kind | string | yes | — |
| ticker | — | yes | — |
| trading_days | number | yes | — |
| transactions_count | — | yes | — |
| turnover_amount | — | yes | — |
| uuid | string | yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. |
| yield_latest_date | — | yes | — |
| yield_max | — | yes | — |
| yield_min | — | yes | — |
| yield_wavg | — | yes | — |
| yield_wavg_latest | — | yes | — |
No examples provided.