TokenBel Financial Data
Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~11,015Tokens (Tool-Definitionen)
~6.2 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (8.61% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"tokenbel-mcp": {
"url": "https://mcp.tokenbel.info/mcp"
}
}
}Remote-Endpunkte
https://mcp.tokenbel.info/mcpstreamable-httphttps://mcp.tokenbel.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (19)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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":"Агрофинанс"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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}.
Eingabe-Schema
{
"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#"
}Ausgabe-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"]}.
Eingabe-Schema
{
"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#"
}Ausgabe-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
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet19 Tools
verifiziertVersion nicht aufgezeichnet19 Tools
verifiziertVersion nicht aufgezeichnet19 Tools