Capabilities
Instrument Search
Search canonical identities, aliases, publishers and source keys. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.
How this capability is exposed
- Stable ID
ursy.finance:instrument-search- Owning service
- URSY.finance
- Runtime
- See the source declaration
Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.
Accepted contract
{
"id": "ursy.finance:instrument-search",
"mcp_tool": "search_instruments",
"description": "Search canonical identities, aliases, publishers and source keys. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.",
"routes": [
{
"operation_id": "searchInstruments",
"method": "GET",
"url": "https://ursy.finance/wp-json/ursy-finance/v2/search",
"rate_limit": {
"bucket": "metadata",
"requests_per_minute": 120
},
"mcp_rate_limit": {
"bucket": "mcp",
"requests_per_minute": 60
}
}
],
"input_schema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 160
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"default": 0
},
"asset_class": {
"type": "string",
"maxLength": 160
},
"country": {
"type": "string",
"maxLength": 160
},
"publisher": {
"type": "string",
"maxLength": 160
},
"source_id": {
"type": "string",
"maxLength": 160
},
"cursor": {
"type": "string",
"maxLength": 2048,
"description": "Preferred pagination: opaque continuation token returned by this operation; keep filters unchanged. Offset is for compatibility or simple browsing."
}
},
"required": [],
"additionalProperties": false
},
"output_schema": {
"type": "object",
"properties": {
"schema": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/instrument/v2"
},
"id": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"asset_class": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"venue": {
"type": [
"string",
"null"
]
},
"publisher": {
"type": [
"string",
"null"
]
},
"provider": {
"type": [
"string",
"null"
]
},
"series_id": {
"type": [
"string",
"null"
]
},
"unit": {
"type": [
"string",
"null"
]
},
"frequency": {
"type": [
"string",
"null"
]
},
"data_kind": {
"type": "string"
},
"source_id": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"methodology_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"identity_status": {
"type": "string"
},
"definition_history": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/definition-history/v2"
},
"status": {
"enum": [
"published_segments",
"specification_only",
"definition_changed_review_required",
"not_retained_in_snapshot",
"not_applicable"
]
},
"metadata_scope": {
"enum": [
"current_registry",
"accepted_snapshot",
"not_applicable"
]
},
"history_complete": {
"const": false
},
"publisher_definition": {
"type": [
"string",
"null"
]
},
"publisher_definition_sha256": {
"type": [
"string",
"null"
]
},
"evidence_url": {
"type": [
"string",
"null"
]
},
"evidence_location": {
"type": [
"string",
"null"
]
},
"date_convention": {
"type": "string"
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"effective_from": {
"type": [
"string",
"null"
]
},
"effective_to": {
"type": [
"string",
"null"
]
},
"effective_from_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_to_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_from_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"effective_to_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"description": {
"type": "string"
}
},
"required": [
"effective_from",
"effective_to",
"effective_from_precision",
"effective_to_precision",
"effective_from_basis",
"effective_to_basis",
"description"
]
}
}
},
"required": [
"schema",
"status",
"metadata_scope",
"history_complete",
"publisher_definition",
"publisher_definition_sha256",
"evidence_url",
"evidence_location",
"date_convention",
"segments"
]
}
},
"required": [
"schema",
"id",
"symbol",
"name",
"asset_class",
"country",
"currency",
"venue",
"publisher",
"provider",
"series_id",
"unit",
"frequency",
"data_kind",
"source_id",
"canonical_url",
"methodology_url",
"source_url",
"aliases",
"identity_status"
]
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
}
},
"required": [
"schema",
"items",
"total",
"limit",
"offset"
]
},
"data_class": "reference",
"auth": "none",
"read_only": true,
"risk": "read_only_reference_information",
"service_id": "ursy-finance",
"parent_id": "",
"name": "Instrument Search",
"summary": "Search canonical identities, aliases, publishers and source keys. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.",
"source_url": "https://ursy.finance/.well-known/ursy-capabilities.json",
"source_type": "capability_manifest",
"verified_at": "2026-09-26 06:31:27",
"revision": "1d32a5adfc6429cc9db7b89642a29e4c28e12f7b17efdc2aadf9aad4674e85ee",
"type": "capabilities",
"source": {
"url": "https://ursy.finance/.well-known/ursy-capabilities.json",
"type": "capability_manifest"
},
"last_verified_at": "2026-09-26 06:31:27",
"stale": true
}