ASTEROID XRPL agent gateway

Schema version 1.0.0.

• discover_asset●available

  Authoritative entry points, capability catalogue, schema versions and exact asset identity.

  mcp · rest:/.well-known/asteroid-agent.json

  Freshness:

  Immutable per release. No ledger read is performed.

  Provenance:

  Static canonical constants; provenance.ledgerIndex is null by design.

  Schema:

  https://asteroidxrpl.com/schemas/v1/discovery-manifest.json

  Limitations:

  Contains no changing ledger state such as supply, holders, liquidity or price.

• get_asset_identity●available

  Canonical immutable identity plus claim-status-separated project metadata.

  mcp · rest:/api/v1/asset

  Freshness:

  Immutable per release. No ledger read is performed.

  Provenance:

  Static canonical constants; provenance.ledgerIndex is null by design.

  Schema:

  https://asteroidxrpl.com/schemas/v1/identity-response.json

  Limitations:

  Wallet roles are owner-confirmed declarations unless marked ledger-verified.

• verify_asset●available

  Compare a candidate network, issuer and currency code against the canonical identity.

  mcp · rest:/.well-known/xrpl-asset.json

  Freshness:

  Immutable per release. No ledger read is performed.

  Provenance:

  Field-by-field comparison against the canonical constants.

  Schema:

  https://asteroidxrpl.com/schemas/v1/verify-response.json

  Limitations:

  All three of network, issuer and currency code are required. The display symbol alone never verifies an asset.

• get_asset_evidence●available

  Historical ledger evidence with transaction hashes, ledger indexes and verification results.

  rest:/api/v1/asset/evidence

  Freshness:

  Re-validated on every request against a validated ledger.

  Provenance:

  XRPL JSON-RPC `tx` reads through the shared validated-ledger client.

  Schema:

  https://asteroidxrpl.com/schemas/v1/ledger-evidence.json

  Limitations:

  Historical anchors only. A failed lookup returns verificationResult "unavailable", never an invented success.

• get_service_health●available

  Per-component availability for the application, schemas, XRPL upstream and identity/evidence services.

  rest:/api/v1/health

  Freshness:

  Evaluated on every request; cached at the edge for at most 30 seconds.

  Provenance:

  Live component probes plus a validated-ledger reachability check.

  Schema:

  https://asteroidxrpl.com/schemas/v1/health-response.json

  Limitations:

  Reports reachability only; it is not a correctness or reliability score.

• get_market_state●available

  Composite ledger-indexed market state: supply, AMM liquidity and fee, LP accessibility, treasury escrows and trust-line counts, each with its own provenance.

  mcp · rest:/api/v1/market

  Freshness:

  Read from a validated ledger on demand and served through a bounded server-side cache (AMM 10s, supply 30s, escrows 60s, holders 120s). The envelope ledgerIndex is the oldest section reading.

  Provenance:

  Composite of the supply, liquidity, escrow and holder services. Each section states its own observedAt, ledgerIndex and method.

  Schema:

  https://asteroidxrpl.com/schemas/v1/market-state.json

  Limitations:

  An observation of ledger state, not a market evaluation, reliability score, quote or transaction preparation. Sections can degrade independently; a null value is never a zero.

• get_supply_state●available

  Outstanding, escrowed, total and circulating ASTEROID supply plus the original issuance revalidated against its anchor transaction.

  mcp · rest:/api/v1/supply

  Freshness:

  Validated-ledger read, cached at most 30 seconds.

  Provenance:

  `gateway_balances` on the issuer for obligations, escrow ledger objects on the project-declared treasury, and a `tx` revalidation of the issuance anchor.

  Schema:

  https://asteroidxrpl.com/schemas/v1/supply-state.json

  Limitations:

  Circulating supply excludes escrowed treasury tokens only; it does not exclude AMM-pooled tokens or tokens held by declared project wallets. Amounts are exact decimal strings and are never rounded for transport.

• get_liquidity_state●available

  ASTEROID/XRP AMM reserves, LP token supply, the XRPL AMM trading fee, and each declared LP-holding account with a live accessibility verdict.

  mcp · rest:/api/v1/liquidity

  Freshness:

  AMM read cached at most 10 seconds; account-control reads cached at most 120 seconds.

  Provenance:

  `amm_info` for the pool, `account_lines` for LP balances, and `account_info` plus `account_objects` (signer_list) for each LP account's control paths.

  Schema:

  https://asteroidxrpl.com/schemas/v1/liquidity-state.json

  Limitations:

  Accessibility is a live observation of signing paths, not a permanence guarantee. The trading fee is a protocol pool fee set by liquidity-provider votes, not a token tax. Not a quote.

• verify_liquidity_lock●available

  Live verification of every project-declared LP-holding account: LP balance, share of LP supply, pro-rata implied reserves and a control assessment from the master key, regular key and signer list, plus an overall verdict.

  mcp · rest:/api/v1/liquidity/lock

  Freshness:

  AMM read cached at most 10 seconds; account-control reads cached at most 120 seconds.

  Provenance:

  A projection of the same liquidity reading — `amm_info`, `account_lines`, `account_info` and `account_objects` (signer_list) — so it can never disagree with get_liquidity_state.

  Schema:

  https://asteroidxrpl.com/schemas/v1/lp-lock-verification.json

  Limitations:

  A closed signing path is an observation at one validated ledger, not a permanence guarantee and not proof that no path exists outside the checks performed. Account roles are owner-confirmed declarations. Not a safety score.

• get_escrow_schedule●available

  Every project-declared treasury ASTEROID escrow with its amount, destination, unlock and cancel times and a locked/releasable/expired state.

  mcp · rest:/api/v1/escrows

  Freshness:

  Validated-ledger read, cached at most 60 seconds.

  Provenance:

  `account_objects` (type=escrow) on the project-declared treasury, filtered to the canonical ASTEROID currency and issuer.

  Schema:

  https://asteroidxrpl.com/schemas/v1/escrow-state.json

  Limitations:

  Escrow objects are ledger-verified; the treasury role of the account is an owner-confirmed declaration. An escrow does not establish who controls the destination account after release.

• get_holder_distribution●available

  Complete trust-line enumeration of the issuer: total trust lines, non-zero holders, completeness flag and the counting methodology.

  mcp · rest:/api/v1/holders

  Freshness:

  Full marker-chain enumeration on one validated ledger, cached at most 120 seconds.

  Provenance:

  `account_lines` on the issuer, paginated to exhaustion on a single ledger.

  Schema:

  https://asteroidxrpl.com/schemas/v1/holder-state.json

  Limitations:

  A trust line is not a person: one holder may control many accounts and custodial accounts aggregate many holders. If the page cap is reached, complete is false and the counts are lower bounds.

• get_swap_quote●available

  Indicative bidirectional ASTEROID/XRP AMM estimate for an exact input or exact output, with fee, spot and effective price, price impact and optional slippage bounds.

  mcp · rest:/api/v1/quote

  Freshness:

  Computed against AMM reserves read from a validated ledger, cached at most 10 seconds.

  Provenance:

  Constant-product XRPL AMM mathematics applied with exact decimal arithmetic to the reserves and trading fee from `amm_info`.

  Schema:

  https://asteroidxrpl.com/schemas/v1/quote-response.json

  Limitations:

  Indicative only and never executable. Every estimate carries a quote identifier, methodology version, validated ledger index and expiry; the identifier reserves nothing and cannot be redeemed. Models the single AMM pool: no order books, no path-finding, no transaction fee, no transfer fee, no slippage protection. Nothing is signed, submitted or prepared and no key or credential is accepted.

• get_project_info◇legacy-available

  Static public reference information: issuer, currency code, declared wallet roles with claim statuses, website, where to buy, official social links and the risk disclaimer.

  mcp

  Freshness:

  Static per release. No ledger read is performed.

  Provenance:

  Project-declared constants. Wallet roles are owner-confirmed, not ledger-proven.

  Schema:

  No published JSON Schema. Untyped JSON object; shape may change without a schema-version bump.

  Limitations:

  Pre-Gate-1 website surface retained for compatibility. It is not enveloped, carries no provenance block and no degraded array, and must not be treated as market evaluation, quoting, simulation, monitoring or transaction preparation. For canonical identity prefer get_asset_identity.

• get_token_stats!deprecated

  Current ASTEROID supply figures, holder count, issuer XRP balance and the balance and supply share of the project-declared takeover qualifying wallet.

  mcp

  Freshness:

  Read on each call from a validated ledger; values change continuously.

  Provenance:

  XRPL JSON-RPC reads through the shared validated-ledger client, plus a public indexer for holder counts.

  Schema:

  No published JSON Schema. Untyped JSON object; shape may change without a schema-version bump.

  Limitations:

  Deprecated: use get_supply_state instead, which is enveloped with provenance, per-value claim statuses, exact decimal strings and stable degraded codes. This tool remains callable for compatibility. Pre-Gate-1 website surface retained for compatibility. It is not enveloped, carries no provenance block and no degraded array, and must not be treated as market evaluation, quoting, simulation, monitoring or transaction preparation. Wallet labels describe declared roles only and imply nothing about ownership, control or accessibility.

• get_liquidity_stats!deprecated

  ASTEROID/XRP AMM pool composition, LP token supply, the XRPL AMM trading fee in basis points, and the split between LP tokens held by project-declared locked accounts and the rest of the community.

  mcp

  Freshness:

  Read on each call from a validated ledger; values change continuously.

  Provenance:

  XRPL JSON-RPC `amm_info` and account reads through the shared client.

  Schema:

  No published JSON Schema. Untyped JSON object; shape may change without a schema-version bump.

  Limitations:

  Deprecated: use get_liquidity_state instead, which is enveloped with provenance, per-value claim statuses, exact decimal strings and stable degraded codes. This tool remains callable for compatibility. Pre-Gate-1 website surface retained for compatibility. It is not enveloped, carries no provenance block and no degraded array, and must not be treated as market evaluation, quoting, simulation, monitoring or transaction preparation. The AMM trading fee is a protocol pool fee set by LP votes; it is not a token tax and can change at any time. This is not a quote and must not be used to price a swap.

• get_escrow_stats!deprecated

  Project-declared treasury escrows on the XRP Ledger with each escrow amount, finish-after and cancel-after dates, plus the total escrowed amount and its share of supply.

  mcp

  Freshness:

  Read on each call from a validated ledger.

  Provenance:

  XRPL JSON-RPC `account_objects` on the project-declared treasury account. The treasury role is owner-confirmed; the escrow objects themselves are ledger-readable.

  Schema:

  No published JSON Schema. Untyped JSON object; shape may change without a schema-version bump.

  Limitations:

  Deprecated: use get_escrow_schedule instead, which is enveloped with provenance, per-value claim statuses, exact decimal strings and stable degraded codes. This tool remains callable for compatibility. Pre-Gate-1 website surface retained for compatibility. It is not enveloped, carries no provenance block and no degraded array, and must not be treated as market evaluation, quoting, simulation, monitoring or transaction preparation. Escrow existence does not establish who controls the destination account after release.

• get_price_history◇legacy-available

  Daily USD price observations for ASTEROID over the last 30 days plus the current price and the 24h and 30d percentage change.

  mcp

  Freshness:

  Third-party daily candles; typically delayed and subject to upstream rate limits.

  Provenance:

  Independently sourced from the public GeckoTerminal API for the ASTEROID/XRP pool. Not a ledger read.

  Schema:

  No published JSON Schema. Untyped JSON object; shape may change without a schema-version bump.

  Limitations:

  Pre-Gate-1 website surface retained for compatibility. It is not enveloped, carries no provenance block and no degraded array, and must not be treated as market evaluation, quoting, simulation, monitoring or transaction preparation. Indicative historical observations only — not a quote, not executable, and no slippage or depth is modelled.

• evaluate_market○planned

  Market evaluation and reliability scoring.

  Freshness:

  Not available.

  Provenance:

  Not available.

  Schema:

  https://asteroidxrpl.com/schemas/v1/response-envelope.json

  Limitations:

  Planned. Not implemented and not callable.

• quote_swap○planned

  Executable quoting, price monitoring and alerting. Indicative estimation is already available through get_swap_quote; execution is not.

  Freshness:

  Not available.

  Provenance:

  Not available.

  Schema:

  https://asteroidxrpl.com/schemas/v1/response-envelope.json

  Limitations:

  Planned. Not implemented and not callable.

• prepare_unsigned_transaction○planned

  Non-custodial unsigned trust-line and swap preparation.

  Freshness:

  Not available.

  Provenance:

  Not available.

  Schema:

  https://asteroidxrpl.com/schemas/v1/response-envelope.json

  Limitations:

  Planned. Not implemented and not callable.

ledger-verified

Established by a validated XRP Ledger read at a stated ledger index.

owner-confirmed

Declared by the project. Not proven by the ledger on its own.

independently-sourced

Sourced from a named third party outside the project.

derived

Calculated from identified ledger inputs using a published methodology.

aspirational

A stated intention about the future, not a current fact.

unresolved

Not currently established; treat as unknown.

• Initial issuance transaction

  ◇historical

  Exactly 8 ASTEROID was issued to r9k6XPd8HDCjwtHhdA8xVYiruhWWUakdw7.

  1CDFEB152DFF302B502CC454806E6DB24E5C70A7C7364CC149FF203C554838CA

  Ledger 103706056

• Issuer regular-key transaction

  ◇historical

  The issuer account set a regular key.

  70D9AFF1A64F15FFE8E8CE0BBDEE65DEE9860C9B26988C7A36F2C89CEE8149FA

  Ledger 103706069

• Issuer master-key disable transaction

  ◇historical

  The issuer account disabled its master key (lsfDisableMaster).

  96A087EFF570B15F6F94B579597B4149F0769350911334990C11FF1F88964CDC

  Ledger 103706070