TokenBel Financial Data
Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~12,532token 数（工具定义）
~6.9 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 9.79%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"tokenbel-mcp": {
"url": "https://mcp.tokenbel.info/mcp"
}
}
}远程端点
https://mcp.tokenbel.info/mcpstreamable-httphttps://mcp.tokenbel.dev/mcpstreamable-http它能做什么
工具清单
工具（19）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢token_get_by_uuid(uuid)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 discovered via token_list."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"platform": {
"type": "string"
},
"status": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"token_price": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"sold": {
"type": [
"number",
"null"
]
},
"emission_stop": {
"type": [
"string",
"null"
]
},
"company_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"company_name": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢token_list(limit, cursor_uuid, cursor_created_at, platform, status)
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.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Max results (1-1000, default 50)"
},
"cursor_uuid": {
"type": "string",
"description": "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 id from next_cursor before the | delimiter."
},
"cursor_created_at": {
"type": "string",
"description": "Pagination cursor datetime (ISO 8601)"
},
"platform": {
"type": "string",
"enum": [
"fainex",
"finstore",
"bynex",
"whitebird"
],
"description": "Filter by tokenization platform: fainex, finstore, bynex, or whitebird."
},
"status": {
"type": "string",
"enum": [
"SELL_NOT_STARTED",
"SELL_IN_PROGRESS",
"SELL_SUSPENDED",
"SOLD_OUT",
"SELL_ENDED",
"CIRCULATION_ENDED",
"OBLIGATIONS_COMPLETED"
],
"description": "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_ENDED (matured/circulation ended), OBLIGATIONS_COMPLETED (issuer obligations completed)."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"tokens": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"platform": {
"type": "string"
},
"status": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"token_price": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"sold": {
"type": [
"number",
"null"
]
},
"emission_stop": {
"type": [
"string",
"null"
]
},
"company_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"company_name": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"tokens",
"count",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢share_get_by_uuid(uuid)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 discovered via search_by_ticker."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"security_kind": {
"type": "string",
"const": "share"
},
"share_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean"
},
"admission_date": {
"type": [
"string",
"null"
]
},
"lot_size": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢share_list(limit, cursor_uuid, cursor_created_at, issuer_uuid, is_trading)
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.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Max results (1-1000, default 50)"
},
"cursor_uuid": {
"type": "string",
"description": "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 id from next_cursor before the | delimiter."
},
"cursor_created_at": {
"type": "string",
"description": "Pagination cursor datetime (ISO 8601)"
},
"issuer_uuid": {
"type": "string",
"description": "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_issuer id from search_by_name result with entity_type=\"issuer\"."
},
"is_trading": {
"type": "boolean",
"description": "Filter by is_traded_today flag: true means traded today, not historical liquidity"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"shares": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"security_kind": {
"type": "string",
"const": "share"
},
"share_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean"
},
"admission_date": {
"type": [
"string",
"null"
]
},
"lot_size": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"shares",
"count",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢share_payouts_get(uuid)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 discovered via search_by_ticker."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"share_uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"period_year": {
"type": "number"
},
"period_type": {
"type": "string"
},
"period_number": {
"type": "number"
},
"amount_per_share": {
"type": "string"
},
"decision_date": {
"type": "string"
},
"record_date": {
"type": "string"
},
"payment_date": {
"type": "string"
},
"value_source": {
"type": "string"
},
"is_frozen": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"required": [
"period_year",
"period_type",
"period_number",
"amount_per_share",
"decision_date",
"record_date",
"payment_date",
"value_source",
"is_frozen",
"status"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"declared_count": {
"type": "number"
},
"no_dividend_count": {
"type": "number"
},
"cancelled_count": {
"type": "number"
},
"total_amount_per_share": {
"type": "string"
},
"max_amount_per_share": {
"type": [
"string",
"null"
]
},
"min_amount_per_share": {
"type": [
"string",
"null"
]
},
"avg_amount_per_share": {
"type": [
"string",
"null"
]
},
"last_payment_date": {
"type": [
"string",
"null"
]
},
"first_payment_date": {
"type": [
"string",
"null"
]
},
"dividend_yield_pct": {
"type": [
"number",
"null"
]
}
},
"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"
],
"additionalProperties": false
}
},
"required": [
"share_uuid",
"ticker",
"currency",
"nominal_value",
"events",
"summary"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢bond_get_by_uuid(uuid)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 discovered via search_by_ticker."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"security_kind": {
"type": "string",
"const": "bond"
},
"bond_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean"
},
"admission_date": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢bond_list(limit, cursor_uuid, cursor_created_at, issuer_uuid, is_trading)
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.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Max results (1-1000, default 50)"
},
"cursor_uuid": {
"type": "string",
"description": "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 id from next_cursor before the | delimiter."
},
"cursor_created_at": {
"type": "string",
"description": "Pagination cursor datetime (ISO 8601)"
},
"issuer_uuid": {
"type": "string",
"description": "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_issuer id from search_by_name result with entity_type=\"issuer\"."
},
"is_trading": {
"type": "boolean",
"description": "Filter by is_traded_today flag: true means traded today, not historical liquidity"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"bonds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"security_kind": {
"type": "string",
"const": "bond"
},
"bond_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean"
},
"admission_date": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"bonds",
"count",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_get_by_uuid(uuid)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 from search_by_name entity_type=\"company\"."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"unp": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"logo_path": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"uuid",
"name",
"full_name",
"unp",
"industry",
"logo_path",
"address",
"is_active",
"created_at",
"updated_at"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_list(limit, cursor_uuid, cursor_created_at, industry)
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.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Max results (1-1000, default 50)"
},
"cursor_uuid": {
"type": "string",
"description": "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 id from next_cursor before the | delimiter."
},
"cursor_created_at": {
"type": "string",
"description": "Pagination cursor datetime (ISO 8601)"
},
"industry": {
"type": "string",
"description": "Filter by company_industry.name exact value"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"companies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"unp": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"logo_path": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"uuid",
"name",
"full_name",
"unp",
"industry",
"logo_path",
"address",
"is_active",
"created_at",
"updated_at"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"companies",
"count",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_by_ticker(query, limit)
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).
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Ticker search query for listed shares/bonds only (case-insensitive substring, e.g. 'MTB' matches 'MTBank')"
},
"limit": {
"default": 20,
"description": "Max results (1-100, default 20)",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"share",
"bond"
]
},
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"is_trading": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean"
},
"admission_date": {
"type": [
"string",
"null"
]
}
},
"required": [
"entity_type",
"uuid",
"ticker",
"kind",
"issuer_uuid",
"issuer_name",
"nominal_value",
"currency",
"is_trading",
"is_active",
"admission_date"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"query": {
"type": "string"
}
},
"required": [
"results",
"count",
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_by_name(query, limit)
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.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Company/issuer name or UNP (Belarusian tax ID) search query; case-insensitive, e.g. 'bank' matches 'MTBank', 'Priorbank'"
},
"limit": {
"default": 20,
"description": "Max results (1-100, default 20)",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"full_name": {
"type": [
"string",
"null"
]
},
"unp": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"logo_path": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"issuer_code": {
"type": [
"string",
"null"
]
},
"issuer_depository": {
"type": [
"string",
"null"
]
},
"linked_company_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"is_active": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"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"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"query": {
"type": "string"
}
},
"required": [
"results",
"count",
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢currency_rate_get(currency, date, date_from, date_to, group_by)
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.
输入模式
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"usd",
"eur",
"rub"
],
"description": "Filter to one supported foreign currency: usd, eur, or rub. Omit to return all three. BYN is the base currency, not a target."
},
"date": {
"type": "string",
"description": "Single date in YYYY-MM-DD format. Mutually exclusive with date_from/date_to."
},
"date_from": {
"type": "string",
"description": "Range start date in YYYY-MM-DD format (inclusive). Can be omitted for open-start range."
},
"date_to": {
"type": "string",
"description": "Range end date in YYYY-MM-DD format (inclusive, >= date_from). Open-ended or today-bounded ranges bypass cache."
},
"group_by": {
"type": "string",
"enum": [
"week",
"month"
],
"description": "Aggregate by week or month. Requires a date range (date_from/date_to), not a single date."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"usd",
"eur",
"rub"
]
},
"rate_date": {
"type": "string"
},
"rate": {
"type": "number"
}
},
"required": [
"currency",
"rate_date",
"rate"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"usd",
"eur",
"rub"
]
},
"period_type": {
"type": "string",
"enum": [
"week",
"month"
]
},
"period_start": {
"type": "string"
},
"avg_rate": {
"type": "number"
},
"min_rate": {
"type": "number"
},
"max_rate": {
"type": "number"
},
"stddev_rate": {
"type": [
"number",
"null"
]
},
"data_points": {
"type": "number"
},
"expected_data_points": {
"type": "number"
},
"is_complete": {
"type": "boolean"
}
},
"required": [
"currency",
"period_type",
"period_start",
"avg_rate",
"min_rate",
"max_rate",
"stddev_rate",
"data_points",
"expected_data_points",
"is_complete"
],
"additionalProperties": false
}
]
}
},
"count": {
"type": "number"
},
"mode": {
"type": "string",
"enum": [
"latest",
"single_date",
"range",
"grouped"
]
},
"base_currency": {
"type": "string"
},
"currency": {
"type": "array",
"items": {
"type": "string"
}
},
"date_from": {
"type": [
"string",
"null"
]
},
"date_to": {
"type": [
"string",
"null"
]
},
"group_by": {
"type": "string",
"enum": [
"week",
"month"
]
}
},
"required": [
"results",
"count",
"mode",
"base_currency",
"currency",
"date_from",
"date_to"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢trading_stats_get(uuid, date_from, date_to)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 bond id, usually discovered via search_by_ticker."
},
"date_from": {
"type": "string",
"description": "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": {
"type": "string",
"description": "Range end date YYYY-MM-DD (inclusive, >= date_from). Provide both date_from and date_to for range mode; ranges ending today bypass cache."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"security_kind": {
"type": "string",
"enum": [
"share",
"bond"
]
},
"ticker": {
"type": [
"string",
"null"
]
},
"mode": {
"type": "string",
"enum": [
"latest_30d",
"range"
]
},
"period": {
"type": "object",
"properties": {
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
}
},
"required": [
"date_from",
"date_to"
],
"additionalProperties": false
},
"last_trade_date": {
"type": [
"string",
"null"
]
},
"trading_days": {
"type": "number"
},
"turnover_amount": {
"type": [
"string",
"null"
]
},
"transactions_count": {
"type": [
"number",
"null"
]
},
"price_wavg": {
"type": [
"string",
"null"
]
},
"price_min": {
"type": [
"string",
"null"
]
},
"price_max": {
"type": [
"string",
"null"
]
},
"price_wavg_latest": {
"type": [
"string",
"null"
]
},
"price_latest_date": {
"type": [
"string",
"null"
]
},
"yield_min": {
"type": [
"string",
"null"
]
},
"yield_max": {
"type": [
"string",
"null"
]
},
"yield_wavg": {
"type": [
"string",
"null"
]
},
"yield_wavg_latest": {
"type": [
"string",
"null"
]
},
"yield_latest_date": {
"type": [
"string",
"null"
]
},
"daily_series": {
"type": "array",
"items": {
"type": "object",
"properties": {
"trade_date": {
"type": "string"
},
"price_min": {
"type": [
"string",
"null"
]
},
"price_max": {
"type": [
"string",
"null"
]
},
"price_wavg": {
"type": [
"string",
"null"
]
},
"turnover_amount": {
"type": "string"
},
"transactions_count": {
"type": "number"
},
"yield_min": {
"type": [
"string",
"null"
]
},
"yield_max": {
"type": [
"string",
"null"
]
}
},
"required": [
"trade_date",
"price_min",
"price_max",
"price_wavg",
"turnover_amount",
"transactions_count",
"yield_min",
"yield_max"
],
"additionalProperties": false
}
}
},
"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"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢token_trading_stats_get(uuid, date_from, date_to)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 discovered via token_list."
},
"date_from": {
"type": "string",
"description": "Range start date YYYY-MM-DD (inclusive). Defaults to date_to minus 30 days when omitted."
},
"date_to": {
"type": "string",
"description": "Range end date YYYY-MM-DD (inclusive, >= date_from). Defaults to today when omitted."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"security_kind": {
"type": "string",
"const": "token"
},
"platform": {
"type": "string"
},
"currency": {
"type": "string"
},
"mode": {
"type": "string",
"const": "range"
},
"period": {
"type": "object",
"properties": {
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
}
},
"required": [
"date_from",
"date_to"
],
"additionalProperties": false
},
"snapshot": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"token_price": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"number",
"null"
]
},
"sold_total": {
"type": "number"
},
"total_tokens": {
"type": "number"
},
"sold_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"status",
"token_price",
"percent_rate",
"sold_total",
"total_tokens",
"sold_pct"
],
"additionalProperties": false
},
"daily": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"tokens_sold": {
"type": "number"
}
},
"required": [
"date",
"tokens_sold"
],
"additionalProperties": false
}
},
"totals": {
"type": "object",
"properties": {
"tokens_sold": {
"type": "number"
},
"active_days": {
"type": "number"
},
"avg_tokens_per_active_day": {
"type": [
"number",
"null"
]
}
},
"required": [
"tokens_sold",
"active_days",
"avg_tokens_per_active_day"
],
"additionalProperties": false
}
},
"required": [
"uuid",
"security_kind",
"platform",
"currency",
"mode",
"period",
"snapshot",
"daily",
"totals"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_financial_params_get(uuid, limit_periods)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 id, usually discovered via search_by_name."
},
"limit_periods": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Max number of periods to return (newest first). Default 8."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"requested_uuid": {
"type": "string",
"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."
},
"requested_entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"company_uuid": {
"type": "string",
"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."
},
"company_name": {
"type": "string"
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"periods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"period_date": {
"type": "string"
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"ratios": {
"anyOf": [
{
"type": "object",
"properties": {
"current_liquidity_ratio": {
"type": [
"string",
"null"
]
},
"financial_liabilities_ratio": {
"type": [
"string",
"null"
]
},
"financial_independence_ratio": {
"type": [
"string",
"null"
]
},
"own_working_capital_ratio": {
"type": [
"string",
"null"
]
},
"financial_stability_ratio": {
"type": [
"string",
"null"
]
},
"capitalization_ratio": {
"type": [
"string",
"null"
]
},
"financial_leverage_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"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"period_date",
"metrics",
"ratios"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"periods",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_tokens_list(uuid, limit, cursor_uuid, cursor_created_at)
List summary cards of a company's active tokens (emissions). Accepts a company OR issuer TokenBel id; resolves the company and returns its tokens.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 id, usually discovered via search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Max results per page (default 50)."
},
"cursor_uuid": {
"type": "string",
"description": "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 part from the next_cursor returned by a prior call; pass both cursor parts together."
},
"cursor_created_at": {
"type": "string",
"description": "Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"requested_uuid": {
"type": "string",
"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."
},
"requested_entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"company_uuid": {
"type": "string",
"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."
},
"company_name": {
"type": "string"
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"tokens": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"name": {
"type": "string"
},
"platform": {
"type": "string"
},
"status": {
"type": "string"
},
"percent_rate": {
"type": [
"string",
"null"
]
},
"token_price": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"total_tokens": {
"type": [
"number",
"null"
]
},
"sold": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": "string"
}
},
"required": [
"uuid",
"name",
"platform",
"status",
"percent_rate",
"token_price",
"currency",
"total_tokens",
"sold",
"created_at"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"limit": {
"type": "number"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"tokens",
"count",
"next_cursor",
"limit"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_shares_list(uuid, limit, cursor_uuid, cursor_created_at)
List summary cards of a company's active shares. Accepts a company OR issuer TokenBel id; resolves the company and returns its shares.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 id, usually discovered via search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Max results per page (default 50)."
},
"cursor_uuid": {
"type": "string",
"description": "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 part from the next_cursor returned by a prior call; pass both cursor parts together."
},
"cursor_created_at": {
"type": "string",
"description": "Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"requested_uuid": {
"type": "string",
"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."
},
"requested_entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"company_uuid": {
"type": "string",
"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."
},
"company_name": {
"type": "string"
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"shares": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"share_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"is_traded_today": {
"type": [
"boolean",
"null"
]
},
"created_at": {
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"share_kind",
"nominal_value",
"currency",
"is_traded_today",
"created_at"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"limit": {
"type": "number"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"shares",
"count",
"next_cursor",
"limit"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢company_bonds_list(uuid, limit, cursor_uuid, cursor_created_at)
List summary cards of a company's active bonds. Accepts a company OR issuer TokenBel id; resolves the company and returns its bonds.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 id, usually discovered via search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Max results per page (default 50)."
},
"cursor_uuid": {
"type": "string",
"description": "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 part from the next_cursor returned by a prior call; pass both cursor parts together."
},
"cursor_created_at": {
"type": "string",
"description": "Opaque cursor datetime part (ISO 8601) from the next_cursor returned by a prior call; pass both cursor parts together."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"requested_uuid": {
"type": "string",
"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."
},
"requested_entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"company_uuid": {
"type": "string",
"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."
},
"company_name": {
"type": "string"
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"bonds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"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."
},
"ticker": {
"type": [
"string",
"null"
]
},
"bond_kind": {
"type": [
"string",
"null"
]
},
"nominal_value": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"percent_rate": {
"type": [
"number",
"null"
]
},
"percent_payment_type": {
"type": [
"string",
"null"
]
},
"maturity_date": {
"type": [
"string",
"null"
]
},
"is_traded_today": {
"type": [
"boolean",
"null"
]
},
"created_at": {
"type": "string"
}
},
"required": [
"uuid",
"ticker",
"bond_kind",
"nominal_value",
"currency",
"percent_rate",
"percent_payment_type",
"maturity_date",
"is_traded_today",
"created_at"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"limit": {
"type": "number"
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"bonds",
"count",
"next_cursor",
"limit"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢entity_news_list(uuid, event_types, impact_types, date_from, date_to, ...)
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.
输入模式
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "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 id, usually discovered via search_by_name."
},
"event_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "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_update, tax_update, market_infrastructure, deposit_event, precious_metal_event, currency_market_event, market_data, other. Case-insensitive."
},
"impact_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional filter on news_event.impact_type. Valid values: positive, neutral, negative, mixed. Case-insensitive."
},
"date_from": {
"type": "string",
"description": "Optional inclusive lower bound on the event date (ISO YYYY-MM-DD)."
},
"date_to": {
"type": "string",
"description": "Optional inclusive upper bound on the event date (ISO YYYY-MM-DD)."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Max results per page (default 20, max 50)."
},
"cursor_event_id": {
"type": "string",
"description": "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": {
"type": "string",
"description": "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."
}
},
"required": [
"uuid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"requested_uuid": {
"type": "string",
"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."
},
"requested_entity_type": {
"type": "string",
"enum": [
"company",
"issuer"
]
},
"company_uuid": {
"type": "string",
"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."
},
"company_name": {
"type": "string"
},
"issuer_uuid": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"issuer_name": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"event_type": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"impact_type": {
"type": [
"string",
"null"
]
},
"confidence": {
"type": [
"number",
"null"
]
},
"key_facts": {
"type": "array",
"items": {
"type": "string"
}
},
"status": {
"type": "string"
},
"created_at": {
"type": "string"
},
"published_at": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"article_url": {
"type": [
"string",
"null"
]
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_id": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"relation_type": {
"type": "string"
},
"match_reason": {
"type": [
"string",
"null"
]
},
"match_confidence": {
"type": [
"number",
"null"
]
},
"display_name": {
"type": [
"string",
"null"
]
},
"source_name": {
"type": [
"string",
"null"
]
},
"parent_entity_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"entity_id",
"entity_type",
"relation_type",
"match_reason",
"match_confidence",
"display_name",
"source_name",
"parent_entity_id"
],
"additionalProperties": false
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_type": {
"type": "string"
},
"slug": {
"type": "string"
},
"display_name": {
"type": "string"
}
},
"required": [
"tag_type",
"slug",
"display_name"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"event_type",
"title",
"slug",
"summary",
"impact_type",
"confidence",
"key_facts",
"status",
"created_at",
"published_at",
"source",
"article_url",
"links",
"tags"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"limit": {
"type": "number"
},
"filters": {
"type": "object",
"properties": {
"event_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"impact_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"date_from": {
"type": [
"string",
"null"
]
},
"date_to": {
"type": [
"string",
"null"
]
}
},
"required": [
"event_types",
"impact_types",
"date_from",
"date_to"
],
"additionalProperties": false
}
},
"required": [
"requested_uuid",
"requested_entity_type",
"company_uuid",
"company_name",
"issuer_uuid",
"issuer_name",
"events",
"count",
"next_cursor",
"limit",
"filters"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本19 个工具
已验证未记录版本19 个工具
已验证未记录版本19 个工具
已验证未记录版本19 个工具