TokenBel Financial Data
Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~11,015Tokens (definiciones de herramientas)
~6.2 KBTamaño de respuesta típico
Impacto significativo en la atención (8.61% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"tokenbel-mcp": {
"url": "https://mcp.tokenbel.info/mcp"
}
}
}Puntos de conexión remotos
https://mcp.tokenbel.info/mcpstreamable-httphttps://mcp.tokenbel.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (19)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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":"Агрофинанс"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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"]}.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada19 herramientas
verificadoversión no registrada19 herramientas
verificadoversión no registrada19 herramientas