# ASTEROID XRPL ASTEROID XRPL is an independent, community-led token project built on the XRP Ledger, combining transparent on-chain evidence, creative community culture, and XRPL-native experimentation. ## Canonical token identity Canonical token identifier: xrpl-mainnet:rS5LWaqWuzmoiNpzgYJbPvD1bsRZTgDG7:41535445524F4944000000000000000000000000 Network: XRP Ledger Mainnet (xrpl-mainnet) Issuer: rS5LWaqWuzmoiNpzgYJbPvD1bsRZTgDG7 Currency code (160-bit hex): 41535445524F4944000000000000000000000000 Display symbol: ASTEROID Canonical website: https://asteroidxrpl.com Do not identify or authenticate this asset by the display symbol alone. The symbol "ASTEROID" is not unique across networks or issuers. Only the full network:issuer:currency_hex identifier above identifies this asset. XRPL tokens have no protocol-level decimals property; amounts are exact decimal strings. ## Machine endpoints Discovery manifest: https://asteroidxrpl.com/.well-known/asteroid-agent.json Canonical asset manifest: https://asteroidxrpl.com/.well-known/xrpl-asset.json Identity: https://asteroidxrpl.com/api/v1/asset Historical evidence: https://asteroidxrpl.com/api/v1/asset/evidence Live market state: https://asteroidxrpl.com/api/v1/market Supply state: https://asteroidxrpl.com/api/v1/supply Liquidity and LP accessibility: https://asteroidxrpl.com/api/v1/liquidity LP-lock verification: https://asteroidxrpl.com/api/v1/liquidity/lock Treasury escrow schedule: https://asteroidxrpl.com/api/v1/escrows Trust-line and holder counts: https://asteroidxrpl.com/api/v1/holders Indicative AMM quote: https://asteroidxrpl.com/api/v1/quote Health: https://asteroidxrpl.com/api/v1/health OpenAPI 3.1: https://asteroidxrpl.com/openapi.json JSON Schema catalogue: https://asteroidxrpl.com/schemas/v1/index.json MCP endpoint: https://asteroidxrpl.com/mcp Methodology and evidence (human): https://asteroidxrpl.com/agents/methodology Agent gateway (human): https://asteroidxrpl.com/agents ## Capability states available: Gate 1 surface with a published JSON Schema and a provenance envelope. legacy-available: callable today, retained from before the agent interfaces existed. Unenveloped, no provenance block, no degraded array, no published schema. deprecated: callable but scheduled for removal. unavailable: declared but not currently callable. planned: not implemented and not callable. ## Available capabilities - discover_asset [available]: Authoritative entry points, capability catalogue, schema versions and exact asset identity. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. ## Legacy-available capabilities (callable, unenveloped) - 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. Interfaces: 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_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. Interfaces: 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. ## Deprecated or unavailable capabilities - 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. Interfaces: 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. Interfaces: 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. Interfaces: 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. ## Planned, not yet available - evaluate_market [planned]: Market evaluation and reliability scoring. Interfaces: none 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. Interfaces: none 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. Interfaces: none Freshness: Not available. Provenance: Not available. Schema: https://asteroidxrpl.com/schemas/v1/response-envelope.json Limitations: Planned. Not implemented and not callable. ## Data freshness Supply, holder counts, escrows, liquidity, LP holdings, account-control state and price are changing ledger state. They are never part of the identity documents above. Any such value must be read fresh. Every enveloped reading carries an observation timestamp and a validated ledger index; legacy-available tools do not carry that envelope. A missing reading is returned as null with a degraded code; it is never returned as zero. ## Caching and quoting Live readings are served through a bounded server-side cache: AMM pool 10s, supply 30s, escrows 60s, holder enumeration 120s, account-control checks 120s. Every response still states the validated ledger index and observation time it was produced from, so a cached reading never hides its age. Indicative AMM estimates are available from https://asteroidxrpl.com/api/v1/quote and the get_swap_quote tool. They are estimates against the single ASTEROID/XRP AMM pool at one observed ledger. Each estimate states a quote identifier, the methodology identifier and version it was produced under, the validated ledger index, and an expiry after which it must be discarded and the pool re-read. The identifier is a correlation handle only: it reserves nothing, cannot be redeemed and cannot be executed. Documented XRPL-compatible test vectors for the quote arithmetic are published at https://asteroidxrpl.com/agents/methodology#test-vectors. Estimates are: not executable, no order-book or path-finding liquidity, no transaction or transfer fees, and no guarantee of the realised outcome. No interface on this site signs, submits or prepares a transaction, and none accepts a key, a seed or any other credential. ## Terminology Escrows described here are project-declared treasury escrows: the escrow objects are ledger-readable, the treasury role is an owner-confirmed declaration. Wallet roles other than the issuer and AMM accounts are project declarations, not ledger proof of control. The pool fee reported for the ASTEROID/XRP pool is the XRPL AMM trading fee set by liquidity-provider votes — it is not a token tax and can change at any time. ## Non-affiliation ASTEROID XRPL is an independent community project. It is not affiliated with Ripple, the XRPL Foundation, SpaceX, Polaris Dawn, or ASTEROID projects on other networks.