Server definition
- Hash
- sha256:04df27e66db0eccb620f11f258a97ab15a13be527e047f8b35d344e14858a502
- What it is
- What a remote MCP server returned when asked what it offers: 19 tools
The blob, as servednamed by its sha256
{
"instructions": "TokenBel AI API — read-only public data for Belarusian securities and NBRB FX rates.\n\nImportant domain model:\n- 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.\n- 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.\n- 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.\n- 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.\n\nResources: 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.\n\nRecommended workflows:\n1. Find share/bond: search_by_ticker(query) -> choose result.uuid exactly as returned -> share_get_by_uuid/bond_get_by_uuid.\n2. Share dividends: search_by_ticker(query) -> choose share.uuid -> share_payouts_get(uuid). dividend_yield_pct is nominal-based, not market-price yield.\n3. 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.\n4. Company/issuer: search_by_name(name_or_unp) -> inspect entity_type before choosing next tool.\n5. 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.\n6. Currency: currency_rate_get returns BYN per 1 unit of usd/eur/rub.\n7. 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).\n8. 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).\n9. 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.\n\nAll tools are read-only and data is public/unauthenticated.\nFull documentation: https://tokenbel.info/.well-known/llms.txt",
"tools": [
{
"description": "Get a BCSE bond's ticker, issuer, coupon, maturity and trading-today flag. Resolve tickers with search_by_ticker first. Example: {\"uuid\":\"76f01f65\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Bond id from search_by_ticker.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "bond_get_by_uuid",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"admission_date": {
"type": [
"string",
"null"
]
},
"bond_kind": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"security_kind": {
"const": "bond",
"type": "string"
},
"ticker": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"name",
"issuer_uuid",
"issuer_name",
"security_kind",
"bond_kind",
"nominal_value",
"currency",
"percent_rate",
"percent_payment_type",
"maturity_date",
"is_trading",
"is_active",
"admission_date",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "List active BCSE bonds by issuer and trading-today status; returns bonds and next_cursor. Use an issuer row from search_by_name. Example: {\"issuer_uuid\":\"45aca6f7\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"is_trading": {
"description": "Traded today on BCSE, not historical liquidity.",
"type": "boolean"
},
"issuer_uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.",
"type": "string"
},
"limit": {
"description": "Page size; default 50 (max 1000).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "bond_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bonds": {
"items": {
"additionalProperties": false,
"properties": {
"admission_date": {
"type": [
"string",
"null"
]
},
"bond_kind": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"security_kind": {
"const": "bond",
"type": "string"
},
"ticker": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"name",
"issuer_uuid",
"issuer_name",
"security_kind",
"bond_kind",
"nominal_value",
"currency",
"percent_rate",
"percent_payment_type",
"maturity_date",
"is_trading",
"is_active",
"admission_date",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"bonds",
"count",
"next_cursor"
],
"type": "object"
}
},
{
"description": "List a company's active bond summary cards and next_cursor. Accepts a company or linked issuer id. Example: {\"uuid\":\"0d3bf3be\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"limit": {
"description": "Page size; default 50.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "company_bonds_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bonds": {
"items": {
"additionalProperties": false,
"properties": {
"bond_kind": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_traded_today": {
"type": [
"boolean",
"null"
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"number",
"null"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"bond_kind",
"nominal_value",
"currency",
"percent_rate",
"percent_payment_type",
"maturity_date",
"is_traded_today",
"created_at"
],
"type": "object"
},
"type": "array"
},
"company_name": {
"type": "string"
},
"company_uuid": {
"description": "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.",
"type": "string"
},
"count": {
"type": "number"
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"requested_entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"requested_uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"bonds",
"count",
"next_cursor",
"limit"
],
"type": "object"
}
},
{
"description": "Get a company's financial statement metrics and ratios, newest periods first. Accepts a company or linked issuer id from search_by_name. Example: {\"uuid\":\"311ff09f\",\"limit_periods\":4}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit_periods": {
"description": "Newest periods to return; default 8 (max 100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "company_financial_params_get",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_name": {
"type": "string"
},
"company_uuid": {
"description": "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.",
"type": "string"
},
"count": {
"type": "number"
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"periods": {
"items": {
"additionalProperties": false,
"properties": {
"metrics": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"period_date": {
"type": "string"
},
"ratios": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"capitalization_ratio": {
"type": [
"string",
"null"
]
},
"current_liquidity_ratio": {
"type": [
"string",
"null"
]
},
"financial_independence_ratio": {
"type": [
"string",
"null"
]
},
"financial_leverage_ratio": {
"type": [
"string",
"null"
]
},
"financial_liabilities_ratio": {
"type": [
"string",
"null"
]
},
"financial_stability_ratio": {
"type": [
"string",
"null"
]
},
"own_working_capital_ratio": {
"type": [
"string",
"null"
]
}
},
"required": [
"current_liquidity_ratio",
"financial_liabilities_ratio",
"financial_independence_ratio",
"own_working_capital_ratio",
"financial_stability_ratio",
"capitalization_ratio",
"financial_leverage_ratio"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"period_date",
"metrics",
"ratios"
],
"type": "object"
},
"type": "array"
},
"requested_entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"requested_uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"periods",
"count"
],
"type": "object"
}
},
{
"description": "Get a company catalogue row, including name, UNP, industry and activity flag; includes inactive companies. Find company IDs with search_by_name. Example: {\"uuid\":\"730f9a9e\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='company'.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "company_get_by_uuid",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"logo_path": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"unp": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"name",
"full_name",
"unp",
"industry",
"logo_path",
"address",
"is_active",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "Browse active companies by industry; returns companies and next_cursor, not issuer rows. For issuers use search_by_name. Example: {\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"industry": {
"description": "Exact company industry name.",
"type": "string"
},
"limit": {
"description": "Page size; default 50 (max 1000).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "company_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"companies": {
"items": {
"additionalProperties": false,
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"logo_path": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"unp": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"name",
"full_name",
"unp",
"industry",
"logo_path",
"address",
"is_active",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"companies",
"count",
"next_cursor"
],
"type": "object"
}
},
{
"description": "List a company's active share summary cards and next_cursor. Accepts a company or linked issuer id. Example: {\"uuid\":\"0d3bf3be\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"limit": {
"description": "Page size; default 50.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "company_shares_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_name": {
"type": "string"
},
"company_uuid": {
"description": "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.",
"type": "string"
},
"count": {
"type": "number"
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"requested_entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"requested_uuid": {
"description": "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.",
"type": "string"
},
"shares": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_traded_today": {
"type": [
"boolean",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"share_kind": {
"type": [
"string",
"null"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"share_kind",
"nominal_value",
"currency",
"is_traded_today",
"created_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"shares",
"count",
"next_cursor",
"limit"
],
"type": "object"
}
},
{
"description": "List a company's active token summary cards and next_cursor. Accepts a company or linked issuer id. Example: {\"uuid\":\"7b860c81\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"limit": {
"description": "Page size; default 50.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "company_tokens_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_name": {
"type": "string"
},
"company_uuid": {
"description": "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.",
"type": "string"
},
"count": {
"type": "number"
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"requested_entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"requested_uuid": {
"description": "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.",
"type": "string"
},
"tokens": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"currency": {
"type": "string"
},
"name": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"platform": {
"type": "string"
},
"sold": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string"
},
"token_price": {
"type": [
"string",
"null"
]
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"name",
"platform",
"status",
"percent_rate",
"token_price",
"currency",
"total_tokens",
"sold",
"created_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"tokens",
"count",
"next_cursor",
"limit"
],
"type": "object"
}
},
{
"description": "Get NBRB FX rates in BYN per 1 USD/EUR/RUB. No dates = latest; date = one day; date_from/date_to = range; group_by + both bounds = weekly/monthly averages. Example: {\"currency\":\"usd\",\"date\":\"2026-06-18\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"currency": {
"description": "Foreign currency; omit for all three. BYN is the base.",
"enum": [
"usd",
"eur",
"rub"
],
"type": "string"
},
"date": {
"description": "YYYY-MM-DD; cannot combine with range dates or group_by.",
"type": "string"
},
"date_from": {
"description": "Inclusive range start (YYYY-MM-DD); optional for open start.",
"type": "string"
},
"date_to": {
"description": "Inclusive range end (YYYY-MM-DD); must be >= date_from.",
"type": "string"
},
"group_by": {
"description": "Week/month average; requires both range dates.",
"enum": [
"week",
"month"
],
"type": "string"
}
},
"type": "object"
},
"name": "currency_rate_get",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base_currency": {
"type": "string"
},
"count": {
"type": "number"
},
"currency": {
"items": {
"type": "string"
},
"type": "array"
},
"date_from": {
"type": [
"string",
"null"
]
},
"date_to": {
"type": [
"string",
"null"
]
},
"group_by": {
"enum": [
"week",
"month"
],
"type": "string"
},
"mode": {
"enum": [
"latest",
"single_date",
"range",
"grouped"
],
"type": "string"
},
"results": {
"items": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"currency": {
"enum": [
"usd",
"eur",
"rub"
],
"type": "string"
},
"rate": {
"type": "number"
},
"rate_date": {
"type": "string"
}
},
"required": [
"currency",
"rate_date",
"rate"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"avg_rate": {
"type": "number"
},
"currency": {
"enum": [
"usd",
"eur",
"rub"
],
"type": "string"
},
"data_points": {
"type": "number"
},
"expected_data_points": {
"type": "number"
},
"is_complete": {
"type": "boolean"
},
"max_rate": {
"type": "number"
},
"min_rate": {
"type": "number"
},
"period_start": {
"type": "string"
},
"period_type": {
"enum": [
"week",
"month"
],
"type": "string"
},
"stddev_rate": {
"type": [
"number",
"null"
]
}
},
"required": [
"currency",
"period_type",
"period_start",
"avg_rate",
"min_rate",
"max_rate",
"stddev_rate",
"data_points",
"expected_data_points",
"is_complete"
],
"type": "object"
}
]
},
"type": "array"
}
},
"required": [
"results",
"count",
"mode",
"base_currency",
"currency",
"date_from",
"date_to"
],
"type": "object"
}
},
{
"description": "List published news across a company/issuer and linked securities; returns events with links, tags and next_cursor. Filter by event/impact type or date. Example: {\"uuid\":\"f2c03989\",\"impact_types\":[\"negative\"]}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_event_id": {
"description": "Numeric event ID before | in next_cursor; pass with cursor_published_at.",
"type": "string"
},
"cursor_published_at": {
"description": "Sort timestamp after | in next_cursor; pass with cursor_event_id.",
"type": "string"
},
"date_from": {
"description": "Inclusive event date start (YYYY-MM-DD).",
"type": "string"
},
"date_to": {
"description": "Inclusive event date end (YYYY-MM-DD).",
"type": "string"
},
"event_types": {
"description": "Types (case-insensitive): company_news, share_event, bond_event, token_event, emission_event, corporate_action, payment_event, default_risk, financial_report, regulatory_update, tax_update, market_infrastructure, deposit_event, precious_metal_event, currency_market_event, market_data, other.",
"items": {
"type": "string"
},
"type": "array"
},
"impact_types": {
"description": "Impact types: positive, neutral, negative, mixed; case-insensitive.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"description": "Page size; default 20 (max 50).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or issuer id from search_by_name.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "entity_news_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_name": {
"type": "string"
},
"company_uuid": {
"description": "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.",
"type": "string"
},
"count": {
"type": "number"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"article_url": {
"type": [
"string",
"null"
]
},
"confidence": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": "string"
},
"event_type": {
"type": [
"string",
"null"
]
},
"id": {
"type": "number"
},
"impact_type": {
"type": [
"string",
"null"
]
},
"key_facts": {
"items": {
"type": "string"
},
"type": "array"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"display_name": {
"type": [
"string",
"null"
]
},
"entity_id": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"match_confidence": {
"type": [
"number",
"null"
]
},
"match_reason": {
"type": [
"string",
"null"
]
},
"parent_entity_id": {
"type": [
"string",
"null"
]
},
"relation_type": {
"type": "string"
},
"source_name": {
"type": [
"string",
"null"
]
}
},
"required": [
"entity_id",
"entity_type",
"relation_type",
"match_reason",
"match_confidence",
"display_name",
"source_name",
"parent_entity_id"
],
"type": "object"
},
"type": "array"
},
"published_at": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"tags": {
"items": {
"additionalProperties": false,
"properties": {
"display_name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tag_type": {
"type": "string"
}
},
"required": [
"tag_type",
"slug",
"display_name"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"event_type",
"title",
"slug",
"summary",
"impact_type",
"confidence",
"key_facts",
"status",
"created_at",
"published_at",
"source",
"article_url",
"links",
"tags"
],
"type": "object"
},
"type": "array"
},
"filters": {
"additionalProperties": false,
"properties": {
"date_from": {
"type": [
"string",
"null"
]
},
"date_to": {
"type": [
"string",
"null"
]
},
"event_types": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"impact_types": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"event_types",
"impact_types",
"date_from",
"date_to"
],
"type": "object"
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"requested_entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"requested_uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"events",
"count",
"next_cursor",
"limit",
"filters"
],
"type": "object"
}
},
{
"description": "Find companies and securities issuers by name or UNP; results tag entity_type. Use company uuid for company_get_by_uuid, issuer uuid for share_list/bond_list; linked_company_uuid joins them when known. Example: {\"query\":\"Агрофинанс\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 20,
"description": "Result cap; default 20 (max 100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Case-insensitive company/issuer name or Belarusian UNP.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_by_name",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"entity_type": {
"enum": [
"company",
"issuer"
],
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"issuer_code": {
"type": [
"string",
"null"
]
},
"issuer_depository": {
"type": [
"string",
"null"
]
},
"linked_company_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"logo_path": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"unp": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"entity_type",
"uuid",
"name",
"full_name",
"unp",
"industry",
"logo_path",
"address",
"issuer_code",
"issuer_depository",
"linked_company_uuid",
"is_active",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results",
"count",
"query"
],
"type": "object"
}
},
{
"description": "Find BCSE shares/bonds by ticker substring; returns entity_type and TokenBel uuid for detail or trading tools. Tokens have no tickers. Example: {\"query\":\"ASB\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 20,
"description": "Result cap; default 20 (max 100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Case-insensitive share/bond ticker substring.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_by_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"admission_date": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"entity_type": {
"enum": [
"share",
"bond"
],
"type": "string"
},
"is_active": {
"type": "boolean"
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"entity_type",
"uuid",
"ticker",
"kind",
"issuer_uuid",
"issuer_name",
"nominal_value",
"currency",
"is_trading",
"is_active",
"admission_date"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results",
"count",
"query"
],
"type": "object"
}
},
{
"description": "Get a BCSE share's ticker, issuer, nominal value and trading-today flag. Resolve tickers with search_by_ticker first. Example: {\"uuid\":\"a97f1fed\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "share_get_by_uuid",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"admission_date": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"lot_size": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"security_kind": {
"const": "share",
"type": "string"
},
"share_kind": {
"type": [
"string",
"null"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"name",
"issuer_uuid",
"issuer_name",
"security_kind",
"share_kind",
"nominal_value",
"currency",
"is_trading",
"is_active",
"admission_date",
"lot_size",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "List active BCSE shares by issuer and trading-today status; returns shares and next_cursor. Use an issuer row from search_by_name. Example: {\"issuer_uuid\":\"0d3bf3be\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"is_trading": {
"description": "Traded today on BCSE, not historical liquidity.",
"type": "boolean"
},
"issuer_uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.",
"type": "string"
},
"limit": {
"description": "Page size; default 50 (max 1000).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "share_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"shares": {
"items": {
"additionalProperties": false,
"properties": {
"admission_date": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"lot_size": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"security_kind": {
"const": "share",
"type": "string"
},
"share_kind": {
"type": [
"string",
"null"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"name",
"issuer_uuid",
"issuer_name",
"security_kind",
"share_kind",
"nominal_value",
"currency",
"is_trading",
"is_active",
"admission_date",
"lot_size",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"shares",
"count",
"next_cursor"
],
"type": "object"
}
},
{
"description": "Get a share's dividend events and declared-payout summary. dividend_yield_pct uses nominal value, not market price; no_dividend/cancelled events are excluded from money totals. Example: {\"uuid\":\"a97f1fed\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "share_payouts_get",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"type": [
"string",
"null"
]
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"amount_per_share": {
"type": "string"
},
"decision_date": {
"type": "string"
},
"is_frozen": {
"type": "boolean"
},
"payment_date": {
"type": "string"
},
"period_number": {
"type": "number"
},
"period_type": {
"type": "string"
},
"period_year": {
"type": "number"
},
"record_date": {
"type": "string"
},
"status": {
"type": "string"
},
"value_source": {
"type": "string"
}
},
"required": [
"period_year",
"period_type",
"period_number",
"amount_per_share",
"decision_date",
"record_date",
"payment_date",
"value_source",
"is_frozen",
"status"
],
"type": "object"
},
"type": "array"
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"share_uuid": {
"description": "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.",
"type": "string"
},
"summary": {
"additionalProperties": false,
"properties": {
"avg_amount_per_share": {
"type": [
"string",
"null"
]
},
"cancelled_count": {
"type": "number"
},
"declared_count": {
"type": "number"
},
"dividend_yield_pct": {
"type": [
"number",
"null"
]
},
"first_payment_date": {
"type": [
"string",
"null"
]
},
"last_payment_date": {
"type": [
"string",
"null"
]
},
"max_amount_per_share": {
"type": [
"string",
"null"
]
},
"min_amount_per_share": {
"type": [
"string",
"null"
]
},
"no_dividend_count": {
"type": "number"
},
"total_amount_per_share": {
"type": "string"
}
},
"required": [
"declared_count",
"no_dividend_count",
"cancelled_count",
"total_amount_per_share",
"max_amount_per_share",
"min_amount_per_share",
"avg_amount_per_share",
"last_payment_date",
"first_payment_date",
"dividend_yield_pct"
],
"type": "object"
},
"ticker": {
"type": [
"string",
"null"
]
}
},
"required": [
"share_uuid",
"ticker",
"currency",
"nominal_value",
"events",
"summary"
],
"type": "object"
}
},
{
"description": "Get a token's platform, sale status, price, rate and issuer. Tokens have no tickers; find the id with token_list. Example: {\"uuid\":\"78c7e502\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "token_get_by_uuid",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_name": {
"type": [
"string",
"null"
]
},
"company_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": "string"
},
"emission_stop": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"name": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"platform": {
"type": "string"
},
"sold": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string"
},
"token_price": {
"type": [
"string",
"null"
]
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"name",
"platform",
"status",
"percent_rate",
"token_price",
"currency",
"total_tokens",
"sold",
"emission_stop",
"company_uuid",
"company_name",
"is_active",
"created_at",
"updated_at"
],
"type": "object"
}
},
{
"description": "Browse active tokenized securities by platform or sale status; returns tokens and next_cursor. Tokens have no tickers. Example: {\"platform\":\"finstore\",\"limit\":20}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor_created_at": {
"description": "Timestamp after | in next_cursor; pass with cursor_uuid.",
"type": "string"
},
"cursor_uuid": {
"description": "ID before | in next_cursor; pass with cursor_created_at.",
"type": "string"
},
"limit": {
"description": "Page size; default 50 (max 1000).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"platform": {
"description": "Tokenization platform.",
"enum": [
"fainex",
"finstore",
"bynex",
"whitebird"
],
"type": "string"
},
"status": {
"description": "Sale/circulation state; SELL_IN_PROGRESS is on sale, SOLD_OUT is fully sold, OBLIGATIONS_COMPLETED is repaid.",
"enum": [
"SELL_NOT_STARTED",
"SELL_IN_PROGRESS",
"SELL_SUSPENDED",
"SOLD_OUT",
"SELL_ENDED",
"CIRCULATION_ENDED",
"OBLIGATIONS_COMPLETED"
],
"type": "string"
}
},
"type": "object"
},
"name": "token_list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"tokens": {
"items": {
"additionalProperties": false,
"properties": {
"company_name": {
"type": [
"string",
"null"
]
},
"company_uuid": {
"anyOf": [
{
"description": "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.",
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"currency": {
"type": "string"
},
"emission_stop": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"name": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"platform": {
"type": "string"
},
"sold": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string"
},
"token_price": {
"type": [
"string",
"null"
]
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"updated_at": {
"type": "string"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"name",
"platform",
"status",
"percent_rate",
"token_price",
"currency",
"total_tokens",
"sold",
"emission_stop",
"company_uuid",
"company_name",
"is_active",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"tokens",
"count",
"next_cursor"
],
"type": "object"
}
},
{
"description": "Get a token's primary-market tokens-sold daily series, totals and snapshot; not secondary trading. No dates = last 30 days; either date bound is allowed. Find the id with token_list. Example: {\"uuid\":\"78c7e502\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date_from": {
"description": "Inclusive YYYY-MM-DD start; defaults to 30 days before end.",
"type": "string"
},
"date_to": {
"description": "Inclusive YYYY-MM-DD end (>= start); defaults to today.",
"type": "string"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "token_trading_stats_get",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"daily": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"tokens_sold": {
"type": "number"
}
},
"required": [
"date",
"tokens_sold"
],
"type": "object"
},
"type": "array"
},
"mode": {
"const": "range",
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
}
},
"required": [
"date_from",
"date_to"
],
"type": "object"
},
"platform": {
"type": "string"
},
"security_kind": {
"const": "token",
"type": "string"
},
"snapshot": {
"additionalProperties": false,
"properties": {
"percent_rate": {
"type": [
"number",
"null"
]
},
"sold_pct": {
"type": [
"number",
"null"
]
},
"sold_total": {
"type": "number"
},
"status": {
"type": "string"
},
"token_price": {
"type": [
"string",
"null"
]
},
"total_tokens": {
"type": "number"
}
},
"required": [
"status",
"token_price",
"percent_rate",
"sold_total",
"total_tokens",
"sold_pct"
],
"type": "object"
},
"totals": {
"additionalProperties": false,
"properties": {
"active_days": {
"type": "number"
},
"avg_tokens_per_active_day": {
"type": [
"number",
"null"
]
},
"tokens_sold": {
"type": "number"
}
},
"required": [
"tokens_sold",
"active_days",
"avg_tokens_per_active_day"
],
"type": "object"
},
"uuid": {
"description": "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.",
"type": "string"
}
},
"required": [
"uuid",
"security_kind",
"platform",
"currency",
"mode",
"period",
"snapshot",
"daily",
"totals"
],
"type": "object"
}
},
{
"description": "Get share/bond trading totals and daily_series. No dates = latest 30 days; both dates = range (yield_wavg and *_latest are null). Find the id with search_by_ticker. Example: {\"uuid\":\"a97f1fed\",\"date_from\":\"2026-06-01\",\"date_to\":\"2026-06-30\"}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date_from": {
"description": "Inclusive YYYY-MM-DD start; supply both dates or neither.",
"type": "string"
},
"date_to": {
"description": "Inclusive YYYY-MM-DD end (>= start); supply both dates or neither.",
"type": "string"
},
"uuid": {
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share/bond id from search_by_ticker.",
"type": "string"
}
},
"required": [
"uuid"
],
"type": "object"
},
"name": "trading_stats_get",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"daily_series": {
"items": {
"additionalProperties": false,
"properties": {
"price_max": {
"type": [
"string",
"null"
]
},
"price_min": {
"type": [
"string",
"null"
]
},
"price_wavg": {
"type": [
"string",
"null"
]
},
"trade_date": {
"type": "string"
},
"transactions_count": {
"type": "number"
},
"turnover_amount": {
"type": "string"
},
"yield_max": {
"type": [
"string",
"null"
]
},
"yield_min": {
"type": [
"string",
"null"
]
}
},
"required": [
"trade_date",
"price_min",
"price_max",
"price_wavg",
"turnover_amount",
"transactions_count",
"yield_min",
"yield_max"
],
"type": "object"
},
"type": "array"
},
"last_trade_date": {
"type": [
"string",
"null"
]
},
"mode": {
"enum": [
"latest_30d",
"range"
],
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
}
},
"required": [
"date_from",
"date_to"
],
"type": "object"
},
"price_latest_date": {
"type": [
"string",
"null"
]
},
"price_max": {
"type": [
"string",
"null"
]
},
"price_min": {
"type": [
"string",
"null"
]
},
"price_wavg": {
"type": [
"string",
"null"
]
},
"price_wavg_latest": {
"type": [
"string",
"null"
]
},
"security_kind": {
"enum": [
"share",
"bond"
],
"type": "string"
},
"ticker": {
"type": [
"string",
"null"
]
},
"trading_days": {
"type": "number"
},
"transactions_count": {
"type": [
"number",
"null"
]
},
"turnover_amount": {
"type": [
"string",
"null"
]
},
"uuid": {
"description": "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.",
"type": "string"
},
"yield_latest_date": {
"type": [
"string",
"null"
]
},
"yield_max": {
"type": [
"string",
"null"
]
},
"yield_min": {
"type": [
"string",
"null"
]
},
"yield_wavg": {
"type": [
"string",
"null"
]
},
"yield_wavg_latest": {
"type": [
"string",
"null"
]
}
},
"required": [
"uuid",
"security_kind",
"ticker",
"mode",
"period",
"last_trade_date",
"trading_days",
"turnover_amount",
"transactions_count",
"price_wavg",
"price_min",
"price_max",
"price_wavg_latest",
"price_latest_date",
"yield_min",
"yield_max",
"yield_wavg",
"yield_wavg_latest",
"yield_latest_date",
"daily_series"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:04df27e66db0eccb620f11f258a97ab15a13be527e047f8b35d344e14858a502 | sha256sum