TokenBel Financial Data
Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~11,015Token（工具定義）
~6.2 KB典型回應大小
顯著的注意力影響（128k 上下文的 8.61%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 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 token's platform, sale status, price, rate and issuer. Tokens have no tickers; find the id with token_list. Example: {"uuid":"78c7e502"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from 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)
Browse active tokenized securities by platform or sale status; returns tokens and next_cursor. Tokens have no tickers. Example: {"platform":"finstore","limit":20}.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Page size; default 50 (max 1000)."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
},
"platform": {
"type": "string",
"enum": [
"fainex",
"finstore",
"bynex",
"whitebird"
],
"description": "Tokenization platform."
},
"status": {
"type": "string",
"enum": [
"SELL_NOT_STARTED",
"SELL_IN_PROGRESS",
"SELL_SUSPENDED",
"SOLD_OUT",
"SELL_ENDED",
"CIRCULATION_ENDED",
"OBLIGATIONS_COMPLETED"
],
"description": "Sale/circulation state; SELL_IN_PROGRESS is on sale, SOLD_OUT is fully sold, OBLIGATIONS_COMPLETED is repaid."
}
},
"$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 BCSE share's ticker, issuer, nominal value and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"a97f1fed"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from 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 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}.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Page size; default 50 (max 1000)."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
},
"issuer_uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'."
},
"is_trading": {
"type": "boolean",
"description": "Traded today on BCSE, 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 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"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from 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 BCSE bond's ticker, issuer, coupon, maturity and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"76f01f65"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Bond id from 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 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}.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Page size; default 50 (max 1000)."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
},
"issuer_uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'."
},
"is_trading": {
"type": "boolean",
"description": "Traded today on BCSE, 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 company catalogue row, including name, UNP, industry and activity flag; includes inactive companies. Find company IDs with search_by_name. Example: {"uuid":"730f9a9e"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). 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)
Browse active companies by industry; returns companies and next_cursor, not issuer rows. For issuers use search_by_name. Example: {"limit":20}.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Page size; default 50 (max 1000)."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
},
"industry": {
"type": "string",
"description": "Exact company industry name."
}
},
"$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)
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"}.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Case-insensitive share/bond ticker substring."
},
"limit": {
"default": 20,
"description": "Result cap; default 20 (max 100).",
"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)
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":"Агрофинанс"}.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Case-insensitive company/issuer name or Belarusian UNP."
},
"limit": {
"default": 20,
"description": "Result cap; default 20 (max 100).",
"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 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"}.
輸入結構描述
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"usd",
"eur",
"rub"
],
"description": "Foreign currency; omit for all three. BYN is the base."
},
"date": {
"type": "string",
"description": "YYYY-MM-DD; cannot combine with range dates or group_by."
},
"date_from": {
"type": "string",
"description": "Inclusive range start (YYYY-MM-DD); optional for open start."
},
"date_to": {
"type": "string",
"description": "Inclusive range end (YYYY-MM-DD); must be >= date_from."
},
"group_by": {
"type": "string",
"enum": [
"week",
"month"
],
"description": "Week/month average; requires both range dates."
}
},
"$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 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"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share/bond id from search_by_ticker."
},
"date_from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD start; supply both dates or neither."
},
"date_to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD end (>= start); supply both dates or neither."
}
},
"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 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"}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list."
},
"date_from": {
"type": "string",
"description": "Inclusive YYYY-MM-DD start; defaults to 30 days before end."
},
"date_to": {
"type": "string",
"description": "Inclusive YYYY-MM-DD end (>= start); defaults to today."
}
},
"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 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}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
},
"limit_periods": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Newest periods to return; default 8 (max 100)."
}
},
"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 a company's active token summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"7b860c81","limit":20}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Page size; default 50."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
}
},
"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 a company's active share summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Page size; default 50."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
}
},
"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 a company's active bond summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Page size; default 50."
},
"cursor_uuid": {
"type": "string",
"description": "ID before | in next_cursor; pass with cursor_created_at."
},
"cursor_created_at": {
"type": "string",
"description": "Timestamp after | in next_cursor; pass with cursor_uuid."
}
},
"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 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"]}.
輸入結構描述
{
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or issuer id from search_by_name."
},
"event_types": {
"type": "array",
"items": {
"type": "string"
},
"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."
},
"impact_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Impact types: positive, neutral, negative, mixed; case-insensitive."
},
"date_from": {
"type": "string",
"description": "Inclusive event date start (YYYY-MM-DD)."
},
"date_to": {
"type": "string",
"description": "Inclusive event date end (YYYY-MM-DD)."
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Page size; default 20 (max 50)."
},
"cursor_event_id": {
"type": "string",
"description": "Numeric event ID before | in next_cursor; pass with cursor_published_at."
},
"cursor_published_at": {
"type": "string",
"description": "Sort timestamp after | in next_cursor; pass with cursor_event_id."
}
},
"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 個工具