ASTEROID XRPL

ASTEROID XRPL .well Known API

The .well Known API from ASTEROID XRPL — 2 operation(s) for .well known.

GitHub OpenAPI

Operations 2

GET /.well-known/asteroid-agent.json Agent discovery manifest #
GET /.well-known/xrpl-asset.json Canonical asset manifest #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/asteroidxrpl-com/openapi/asteroidxrpl-com-well-known-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-quote-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-liquidity-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-lp-lock-verification-schema.json
📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-supply-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-discovery-manifest-schema.json
📊
JSONSchema
https://artifacts.apis.io/asteroidxrpl-com/json-schema/asteroidxrpl-com-escrow-state-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/asteroidxrpl-com:asteroidxrpl-com-well-known-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

asteroidxrpl-com-well-known-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ASTEROID XRPL Agent .well Known API
  version: 1.0.0
  summary: Machine discovery and canonical identity for the ASTEROID token on XRPL Mainnet.
  description: '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 identifier: xrpl-mainnet:rS5LWaqWuzmoiNpzgYJbPvD1bsRZTgDG7:41535445524F4944000000000000000000000000


    Identify this asset only by the full network:issuer:currency_hex identifier. The display symbol ASTEROID alone is not sufficient and does not establish authenticity.


    Live readings are ledger-indexed and cached for a bounded interval: AMM 10s, supply 30s, escrows 60s, holders 120s. Quotes are indicative estimates against the single ASTEROID/XRP AMM pool and are never executable. No endpoint signs, submits or prepares a transaction, and no endpoint accepts a key, a seed or any credential.


    All responses use a shared envelope with schemaVersion, data, provenance, degraded and links. Changing ledger-backed readings carry an observedAt timestamp and a validated ledgerIndex. Missing readings are returned as null with a stable degraded code and are never coerced to zero. Token quantities are exact decimal strings.


    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.'
  license:
    name: Public read-only
    identifier: CC-BY-4.0
servers:
- url: https://asteroidxrpl.com
tags:
- name: .well Known
paths:
  /.well-known/asteroid-agent.json:
    get:
      operationId: getDiscoveryManifest
      summary: Agent discovery manifest
      description: Authoritative entry points, exact asset identity, schema version and the capability catalogue. Planned capabilities are marked planned and are not operational.
      responses:
        '200':
          description: Discovery manifest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/discovery-manifest'
      tags:
      - .well Known
  /.well-known/xrpl-asset.json:
    get:
      operationId: getAssetManifest
      summary: Canonical asset manifest
      description: Immutable identity, project declarations, historical anchors and claim statuses. Contains no changing ledger metrics.
      responses:
        '200':
          description: Asset manifest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/asset-manifest'
      tags:
      - .well Known
components:
  schemas:
    asset-manifest:
      title: ASTEROID canonical asset manifest
      type: object
      required:
      - schemaVersion
      - $schema
      - publishedAt
      - canonicalAsset
      - projectIdentity
      - historicalAnchors
      - claimStatuses
      - dynamicData
      - links
      properties:
        schemaVersion:
          type: string
        $schema:
          type: string
          format: uri
        publishedAt:
          type: string
          format: date-time
        canonicalAsset:
          $ref: '#/components/schemas/canonical-asset'
        projectIdentity:
          $ref: '#/components/schemas/project-identity'
        historicalAnchors:
          type: array
          items:
            type: object
            required:
            - id
            - label
            - hash
            - ledgerIndex
            - claim
            additionalProperties: false
            properties:
              id:
                type: string
              label:
                type: string
              hash:
                type: string
                pattern: ^[0-9A-F]{64}$
              ledgerIndex:
                type:
                - integer
                - 'null'
              claim:
                type: string
        claimStatuses:
          type: array
          items:
            type: object
            required:
            - status
            - meaning
            additionalProperties: false
            properties:
              status:
                type: string
                enum:
                - ledger-verified
                - owner-confirmed
                - independently-sourced
                - derived
                - aspirational
                - unresolved
              meaning:
                type: string
        dynamicData:
          type: object
          required:
          - note
          - endpoints
          properties:
            note:
              type: string
            endpoints:
              type: object
              additionalProperties:
                type: string
        links:
          type: object
          additionalProperties:
            type: string
    project-identity:
      title: ASTEROID project identity
      type: object
      required:
      - name
      - description
      - descriptionClaimStatus
      - canonicalWebsite
      - network
      - approvalAuthority
      - approvalAuthorityClaimStatus
      - nonAffiliation
      - declaredWallets
      additionalProperties: false
      properties:
        name:
          type: string
        description:
          type: string
        descriptionClaimStatus:
          type: string
          enum:
          - ledger-verified
          - owner-confirmed
          - independently-sourced
          - derived
          - aspirational
          - unresolved
        canonicalWebsite:
          type: string
          format: uri
        network:
          type: string
        approvalAuthority:
          type: string
        approvalAuthorityClaimStatus:
          type: string
          enum:
          - ledger-verified
          - owner-confirmed
          - independently-sourced
          - derived
          - aspirational
          - unresolved
        nonAffiliation:
          type: string
        declaredWallets:
          type: array
          items:
            type: object
            required:
            - address
            - role
            - claimStatus
            - note
            additionalProperties: false
            properties:
              address:
                type: string
              role:
                type: string
              claimStatus:
                type: string
                enum:
                - ledger-verified
                - owner-confirmed
                - independently-sourced
                - derived
                - aspirational
                - unresolved
              note:
                type: string
    canonical-asset:
      title: Canonical ASTEROID asset identity
      type: object
      required:
      - tokenId
      - network
      - networkName
      - issuer
      - currencyHex
      - displaySymbol
      - projectName
      - canonicalWebsite
      - identifierPolicy
      - precisionPolicy
      - claimStatus
      additionalProperties: false
      properties:
        tokenId:
          type: string
          pattern: ^[a-z0-9-]+:r[1-9A-HJ-NP-Za-km-z]{24,34}:[0-9A-F]{40}$
        network:
          type: string
        networkName:
          type: string
        issuer:
          type: string
          pattern: ^r[1-9A-HJ-NP-Za-km-z]{24,34}$
        currencyHex:
          type: string
          pattern: ^[0-9A-F]{40}$
        displaySymbol:
          type: string
        projectName:
          type: string
        canonicalWebsite:
          type: string
          format: uri
        identifierPolicy:
          type: string
        precisionPolicy:
          type: string
        claimStatus:
          type: string
          enum:
          - ledger-verified
          - owner-confirmed
          - independently-sourced
          - derived
          - aspirational
          - unresolved
    discovery-manifest:
      title: ASTEROID agent discovery manifest
      type: object
      required:
      - schemaVersion
      - $schema
      - publishedAt
      - project
      - asset
      - resources
      - capabilities
      - claimStatuses
      - nonAffiliation
      additionalProperties: false
      properties:
        schemaVersion:
          type: string
        $schema:
          type: string
          format: uri
        publishedAt:
          type: string
          format: date-time
        project:
          type: object
          required:
          - name
          - description
          - canonicalWebsite
          additionalProperties: false
          properties:
            name:
              type: string
            description:
              type: string
            canonicalWebsite:
              type: string
              format: uri
        asset:
          type: object
          required:
          - tokenId
          - network
          - networkName
          - issuer
          - currencyHex
          - displaySymbol
          - identifierPolicy
          additionalProperties: false
          properties:
            tokenId:
              type: string
            network:
              type: string
            networkName:
              type: string
            issuer:
              type: string
            currencyHex:
              type: string
              pattern: ^[0-9A-F]{40}$
            displaySymbol:
              type: string
            identifierPolicy:
              type: string
        resources:
          type: object
          additionalProperties:
            type: string
            format: uri
        capabilities:
          type: array
          items:
            type: object
            required:
            - name
            - description
            - status
            - interfaces
            - freshness
            - provenanceNote
            - schema
            - limitations
            additionalProperties: false
            properties:
              name:
                type: string
              description:
                type: string
              status:
                type: string
                enum:
                - available
                - legacy-available
                - deprecated
                - unavailable
                - planned
                description: 'available: Gate 1 surface with a published schema. legacy-available: retained pre-Gate-1 surface, callable but unenveloped. deprecated: callable, scheduled for removal. unavailable: declared but not currently callable. planned: not implemented and not callable.'
              interfaces:
                type: array
                items:
                  type: string
              freshness:
                type: string
              provenanceNote:
                type: string
              schema:
                type: string
              limitations:
                type: string
        claimStatuses:
          type: array
          items:
            type: object
            required:
            - status
            - meaning
            additionalProperties: false
            properties:
              status:
                type: string
                enum:
                - ledger-verified
                - owner-confirmed
                - independently-sourced
                - derived
                - aspirational
                - unresolved
              meaning:
                type: string
        nonAffiliation:
          type: string
externalDocs:
  description: Agent gateway
  url: https://asteroidxrpl.com/agents
x-schema-base: https://asteroidxrpl.com/schemas/v1
x-mcp-endpoint: https://asteroidxrpl.com/mcp