Kryptonian Labs XRPL APIs
Read-only XRP Ledger data for agents: fees, order books, slippage, AMM pools, accounts and health.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~6,577Token（工具定義）
~7.8 KB典型回應大小
顯著的注意力影響（128k 上下文的 5.14%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"xrpl": {
"url": "https://api.kriptonianlabs.com/mcp"
}
}
}遠端端點
https://api.kriptonianlabs.com/mcpstreamable-http它能做什麼
工具清單
工具（7）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢get_fee
Current XRPL fee tiers in drops with a congestion score. When to use: Before submitting a transaction, to choose a `Fee` and to decide whether the network is congested. Prefer another tool: Not a price feed and not a historical series; it describes the latest validated ledger only. Example: get_fee {}
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"fee": {
"type": "object",
"properties": {
"economy": {
"type": "string",
"description": "Drops"
},
"standard": {
"type": "string",
"description": "Drops"
},
"priority": {
"type": "string",
"description": "Drops"
}
},
"required": [
"economy",
"standard",
"priority"
],
"additionalProperties": false
},
"congestion": {
"type": "object",
"properties": {
"score": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"band": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"load_factor_assumed": {
"type": "boolean"
}
},
"required": [
"score",
"band",
"load_factor_assumed"
],
"additionalProperties": false
},
"base_fee": {
"type": "string",
"description": "Decimal string"
},
"median_fee": {
"type": "string",
"description": "Decimal string"
},
"minimum_fee": {
"type": "string",
"description": "Decimal string"
},
"open_ledger_fee": {
"type": "string",
"description": "Decimal string"
},
"current_queue_size": {
"type": "string",
"description": "Decimal string"
},
"max_queue_size": {
"type": "string",
"description": "Decimal string"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"fee",
"congestion",
"base_fee",
"median_fee",
"minimum_fee",
"open_ledger_fee",
"current_queue_size",
"max_queue_size",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢get_network_health
Overall and per-node health of the upstream XRPL nodes. When to use: To decide whether to trust or retry data, or to explain a 503 from another endpoint. Prefer another tool: Not a probe of your own connectivity; it reports the service's upstream nodes. Example: get_network_health {}
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"degraded",
"down",
"unknown"
]
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"member": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"up",
"down"
]
},
"latency_ms": {
"type": [
"number",
"null"
]
},
"ledger_index": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"ledger_age_s": {
"type": [
"number",
"null"
]
},
"load_factor": {
"type": [
"number",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"sampled_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"member",
"state",
"latency_ms",
"ledger_index",
"ledger_age_s",
"load_factor",
"error",
"sampled_at"
],
"additionalProperties": false
}
},
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"last_probe_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"status",
"nodes",
"ledger_index",
"last_probe_at",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢get_orderbook(base, quote, depth)
CLOB order book for a currency pair with unfunded offers removed. When to use: To read executable liquidity for a pair on the XRPL central limit order book (CLOB). Prefer another tool: Not for AMM liquidity (use the amm page) and not for a cost estimate (use the slippage page). Example: get_orderbook {"base":"XRP","quote":"USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"}
輸入結構描述
{
"type": "object",
"properties": {
"base": {
"type": "string",
"description": "Base currency: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
},
"quote": {
"type": "string",
"description": "Quote currency: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
},
"depth": {
"description": "Levels per side: a positive integer, rounded up to 10, 50, 100 or 200 (max 200)",
"type": "string"
}
},
"required": [
"base",
"quote"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"base": {
"type": "string"
},
"quote": {
"type": "string"
},
"depth": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"asks": {
"type": "array",
"items": {
"$ref": "#/$defs/BookLevel"
},
"description": "Best (lowest) price first"
},
"bids": {
"type": "array",
"items": {
"$ref": "#/$defs/BookLevel"
},
"description": "Best (highest) price first, from the base-asset side"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"base",
"quote",
"depth",
"asks",
"bids",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"BookLevel": {
"type": "object",
"properties": {
"gets": {
"type": "string",
"description": "Decimal string"
},
"pays": {
"type": "string",
"description": "Decimal string"
},
"price": {
"type": "string",
"description": "Pays per gets, decimal string"
}
},
"required": [
"gets",
"pays",
"price"
],
"additionalProperties": false
},
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢estimate_slippage(base, quote, amount, depth)
Slippage and average price for buying an amount of base currency. When to use: Before placing a market-style trade, to size it against available depth and to see whether the CLOB or the AMM pool is the cheaper venue. Prefer another tool: It is an estimate, not a quote, and it does not split an amount across venues or route through other pairs. To read pool reserves, use the amm page. Example: estimate_slippage {"base":"XRP","quote":"USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","amount":"1000"}
輸入結構描述
{
"type": "object",
"properties": {
"base": {
"type": "string",
"description": "Base currency: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
},
"quote": {
"type": "string",
"description": "Quote currency: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
},
"amount": {
"type": "string",
"description": "Positive decimal amount of base to buy"
},
"depth": {
"description": "Levels per side: a positive integer, rounded up to 10, 50, 100 or 200 (max 200)",
"type": "string"
}
},
"required": [
"base",
"quote",
"amount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"base": {
"type": "string"
},
"quote": {
"type": "string"
},
"side": {
"type": "string",
"const": "buy"
},
"depth": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"amount": {
"type": "string",
"description": "Decimal string"
},
"filled": {
"type": "string",
"description": "Decimal string"
},
"partial": {
"type": "boolean"
},
"insufficient_liquidity": {
"type": "boolean"
},
"best_price": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
]
},
"avg_price": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
]
},
"slippage_pct": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Percent, null when liquidity is insufficient"
},
"transfer_fee_applied": {
"type": "boolean"
},
"transfer_fee": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
]
},
"avg_price_after_fees": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
]
},
"venues": {
"type": "object",
"properties": {
"best": {
"anyOf": [
{
"type": "string",
"enum": [
"clob",
"amm"
]
},
{
"type": "null"
}
],
"description": "Cheaper venue by avg_price (ties go to the CLOB), null when neither can fill"
},
"amm_status": {
"type": "string",
"enum": [
"ok",
"stale",
"no_pool",
"unavailable"
],
"description": "State of the AMM read: ok, stale (served past its fresh window), no_pool, unavailable"
},
"clob": {
"type": "object",
"properties": {
"avg_price": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Quote paid per base received, null when it cannot fill"
},
"cost": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Total quote paid for `amount`, null when it cannot fill"
},
"slippage_pct": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Percent vs the best ask, null when it cannot fill"
},
"insufficient_liquidity": {
"type": "boolean"
},
"avg_price_after_fees": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "avg_price x issuer TransferRate, null when the rate is unknown"
}
},
"required": [
"avg_price",
"cost",
"slippage_pct",
"insufficient_liquidity",
"avg_price_after_fees"
],
"additionalProperties": false
},
"amm": {
"anyOf": [
{
"type": "object",
"properties": {
"avg_price": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Quote paid per base received, null when it cannot fill"
},
"cost": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Total quote paid for `amount`, null when it cannot fill"
},
"slippage_pct": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "Percent vs the fee-free pool spot price (includes the trading fee), null when it cannot fill"
},
"insufficient_liquidity": {
"type": "boolean"
},
"avg_price_after_fees": {
"anyOf": [
{
"type": "string",
"description": "Decimal string"
},
{
"type": "null"
}
],
"description": "avg_price x issuer TransferRate, null when the rate is unknown"
},
"spot_price": {
"type": "string",
"description": "Pool spot price, quote per base, excluding fee and impact"
},
"trading_fee": {
"type": "string",
"description": "Pool trading fee as a fraction, like /v1/amm"
}
},
"required": [
"avg_price",
"cost",
"slippage_pct",
"insufficient_liquidity",
"avg_price_after_fees",
"spot_price",
"trading_fee"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Null when the pair has no pool or the pool could not be read (see amm_status)"
}
},
"required": [
"best",
"amm_status",
"clob",
"amm"
],
"additionalProperties": false,
"description": "CLOB vs AMM comparison for the same amount; no routing split"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"base",
"quote",
"side",
"depth",
"amount",
"filled",
"partial",
"insufficient_liquidity",
"best_price",
"avg_price",
"slippage_pct",
"transfer_fee_applied",
"transfer_fee",
"avg_price_after_fees",
"venues",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢get_amm(a, b)
AMM pool reserves and trading fee for an asset pair. When to use: To read AMM pool depth and fee for a pair. Prefer another tool: It does not estimate slippage or compare venues (use the slippage page for the CLOB vs AMM comparison); a pair without a pool returns 404. Example: get_amm {"a":"XRP","b":"USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"}
輸入結構描述
{
"type": "object",
"properties": {
"a": {
"type": "string",
"description": "First asset: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
},
"b": {
"type": "string",
"description": "Second asset: `XRP` (no issuer) or `CODE.issuer` with a valid classic-address issuer (e.g. `USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh`)"
}
},
"required": [
"a",
"b"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"asset_a": {
"type": "string"
},
"asset_b": {
"type": "string"
},
"reserve_a": {
"type": "string",
"description": "Decimal string"
},
"reserve_b": {
"type": "string",
"description": "Decimal string"
},
"trading_fee": {
"type": "string",
"description": "Decimal string"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"asset_a",
"asset_b",
"reserve_a",
"reserve_b",
"trading_fee",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢get_account_summary(address)
XRP balance, sequence, owner count, transfer rate and trust lines (capped) for an account. When to use: To inspect an account before building a transaction for it. Prefer another tool: Not for transaction history, reserves or account flags; it is a summary, not a full account dump. Example: get_account_summary {"address":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"}
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Valid classic XRPL account address (r..., checksum verified)"
}
},
"required": [
"address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string"
},
"balance_xrp": {
"type": "string",
"description": "Decimal string"
},
"sequence": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"owner_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"transfer_rate": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Issuer TransferRate, 1000000000 = no fee"
},
"trust_lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"issuer": {
"type": "string"
},
"balance": {
"type": "string",
"description": "Decimal string"
},
"limit": {
"type": "string",
"description": "Decimal string"
}
},
"required": [
"currency",
"issuer",
"balance",
"limit"
],
"additionalProperties": false
}
},
"lines_truncated": {
"type": "boolean"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"address",
"balance_xrp",
"sequence",
"owner_count",
"transfer_rate",
"trust_lines",
"lines_truncated",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}🟢get_latest_ledger
Latest validated ledger index, hash and close time. When to use: To anchor other readings to a ledger or to check how current the network view is. Prefer another tool: Not for transaction data or account state; use the account endpoint for those. Example: get_latest_ledger {}
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"close_time": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"ledger_hash": {
"type": [
"string",
"null"
]
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"ledger_index",
"close_time",
"ledger_hash",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"Meta": {
"type": "object",
"properties": {
"ledger_index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Validated ledger the data comes from"
},
"as_of": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "When the data was read from the ledger"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Age of the data at response time"
},
"cache": {
"type": "string",
"enum": [
"hit",
"miss",
"stale"
]
},
"stale": {
"type": "boolean",
"description": "True when served past its fresh TTL (stale-on-error)"
}
},
"required": [
"ledger_index",
"as_of",
"age_seconds",
"cache",
"stale"
],
"additionalProperties": false
}
}
}社群
證據
近期觀測
已驗證未記錄版本7 個工具