Risk history of a Stellar asset
get_risk_historyRetrieves historical risk readings for one asset, including risk band, flags, depth, and max safe collateral, for a ledger window or all stored source data.
Instructions
A time series of band, flags, depth and max safe collateral for one asset, from ONE data source. Give from and to (ledger sequences, at most 90 days apart) for a window, or omit both to list every stored reading of that source. Reconstructions such as the February 2026 USTRY series live under source offers-implied and are reachable only with both bounds omitted. Band changes are summarised.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"assetId": "<assetId>"
},
"name": "get_risk_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last ledger, inclusive. Requires from. | |
| from | No | First ledger, inclusive. Requires to. | |
| limit | No | Most points to return. Default 200 here (the API allows up to 5000). | |
| quote | No | Optional quote asset id. Omit it: every monitored asset is measured against USDC, and every notional in the answer is in that quote asset. | |
| source | No | horizon (default) and hubble are direct readings; offers-implied and trades-implied are reconstructions, and trades-implied is a lower bound. | |
| assetId | Yes | Keel asset id: CODE:ISSUER for an issued asset (for example USTRY:GCRYUGD5NVARGXT56XEZI5CIFCQETYHAPQQTHO2O3IQZTHDH4LATMYWC), or XLM. An asset is the (code, issuer) pair, never the ticker alone: use find_asset first when only a code is known. | |
| resolution | No | Bucket size for a windowed request. Default day. |