dnsofmoney-com

dnsofmoney-com Founding API

The Founding API from dnsofmoney-com — 18 operation(s) for founding.

GitHub OpenAPI

Operations 18

GET /api/v1/founding/status Founding Status #
GET /api/v1/founding/wallet-check/{xrpl_address} Check if a wallet already has a founding alias #
GET /api/v1/founding/available/{alias_name} Check if a pay: alias is available #
POST /api/v1/founding/create-payment Create Xaman Payment #
GET /api/v1/founding/payload-result/{payload_uuid} Get Payload Result #
POST /api/v1/founding/recover Founding Recover #
POST /api/v1/founding/register Founding Register #
GET /api/v1/founding/identity-status/{alias_id} Founding Identity Status #
POST /api/v1/founding/claim-nft Claim Nft #
POST /api/v1/founding/wallet-signin Wallet Signin #
GET /api/v1/founding/wallet/{xrpl_address}/nfts Wallet Nfts #
POST /api/v1/founding/burn-nft Burn Nft #
POST /api/v1/founding/transfer/offer Transfer Offer #
POST /api/v1/founding/transfer/accept Transfer Accept #
GET /api/v1/founding/transfer/offers/{nft_token_id} Transfer Offers #
POST /api/v1/founding/transfer/sync Transfer Sync #
GET /api/v1/founding/xrpl-balance/{xrpl_address} Check XRPL account balance and reserve safety for NFT claim #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dnsofmoney-com/openapi/dnsofmoney-com-founding-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-send-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-delivery-quote-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-swap-quote-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-access-request-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-ap2-purchase-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/dnsofmoney-com/json-schema/dnsofmoney-com-send-response-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/dnsofmoney-com:dnsofmoney-com-founding-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

dnsofmoney-com-founding-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: dns://money - Financial Address Resolution Founding API
  version: 0.3.0
tags:
- name: Founding
paths:
  /api/v1/founding/status:
    get:
      summary: Founding Status
      description: Public founding tier status.
      operationId: founding_status_api_v1_founding_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Founding
  /api/v1/founding/wallet-check/{xrpl_address}:
    get:
      summary: Check if a wallet already has a founding alias
      description: Check if a wallet already registered a founding name. Call before payment.
      operationId: wallet_check_api_v1_founding_wallet_check__xrpl_address__get
      parameters:
      - name: xrpl_address
        in: path
        required: true
        schema:
          type: string
          title: Xrpl Address
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/available/{alias_name}:
    get:
      summary: 'Check if a pay: alias is available'
      description: Public — no auth required. Returns available/taken/reserved/invalid.
      operationId: check_alias_availability_api_v1_founding_available__alias_name__get
      parameters:
      - name: alias_name
        in: path
        required: true
        schema:
          type: string
          title: Alias Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/create-payment:
    post:
      summary: Create Xaman Payment
      description: Create a Xaman payment request server-side. Returns QR + deeplink.
      operationId: create_xaman_payment_api_v1_founding_create_payment_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePaymentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/payload-result/{payload_uuid}:
    get:
      summary: Get Payload Result
      description: Check Xaman payload result — was it signed? Get TX hash + signer.
      operationId: get_payload_result_api_v1_founding_payload_result__payload_uuid__get
      parameters:
      - name: payload_uuid
        in: path
        required: true
        schema:
          type: string
          title: Payload Uuid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/recover:
    post:
      summary: Founding Recover
      description: 'Idempotent registration recovery.


        Call this when the page closed after payment but before /register completed.

        - If TX hash is already registered: returns the existing alias (200, recovered=true).

        - If not yet registered: runs the full registration and returns 201.


        This eliminates admin intervention for the "paid but page closed" failure mode.'
      operationId: founding_recover_api_v1_founding_recover_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FoundingAliasCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/register:
    post:
      summary: Founding Register
      description: Register a founding tier alias.
      operationId: founding_register_api_v1_founding_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FoundingAliasCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/identity-status/{alias_id}:
    get:
      summary: Founding Identity Status
      description: Poll identity pipeline status for a founding alias.
      operationId: founding_identity_status_api_v1_founding_identity_status__alias_id__get
      parameters:
      - name: alias_id
        in: path
        required: true
        schema:
          type: string
          title: Alias Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/claim-nft:
    post:
      summary: Claim Nft
      description: Create a Xaman NFTokenAcceptOffer payload so the user can claim their NFT.
      operationId: claim_nft_api_v1_founding_claim_nft_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaimNFTRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/wallet-signin:
    post:
      summary: Wallet Signin
      description: Create a Xaman SignIn payload — no payment, just identity proof.
      operationId: wallet_signin_api_v1_founding_wallet_signin_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Founding
  /api/v1/founding/wallet/{xrpl_address}/nfts:
    get:
      summary: Wallet Nfts
      description: List all founding aliases + NFTs for a wallet address.
      operationId: wallet_nfts_api_v1_founding_wallet__xrpl_address__nfts_get
      parameters:
      - name: xrpl_address
        in: path
        required: true
        schema:
          type: string
          title: Xrpl Address
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/burn-nft:
    post:
      summary: Burn Nft
      description: 'Burn an NFT for a founding alias.


        - Unclaimed (still in minter wallet): server-side burn, immediate.

        - Claimed (in user wallet): returns Xaman NFTokenBurn payload for user to sign.'
      operationId: burn_nft_api_v1_founding_burn_nft_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BurnNFTRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/transfer/offer:
    post:
      summary: Transfer Offer
      description: 'Owner-signed NFTokenCreateOffer that hands a claimed founding NFT to another wallet.


        The owner signs in their own wallet (we never hold the NFT once it''s claimed),

        so this only builds the Xaman payload. Destination-scoped: only that wallet can

        accept. amount_drops="0" gifts the name; a positive value sells it.'
      operationId: transfer_offer_api_v1_founding_transfer_offer_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferOfferRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/transfer/accept:
    post:
      summary: Transfer Accept
      description: Recipient-signed NFTokenAcceptOffer for a peer-to-peer sell offer.
      operationId: transfer_accept_api_v1_founding_transfer_accept_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferAcceptRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/transfer/offers/{nft_token_id}:
    get:
      summary: Transfer Offers
      description: 'List active on-chain sell offers for an NFT so a recipient can find the offer id.


        Reads the ledger directly (chain is source of truth for the founding tier).'
      operationId: transfer_offers_api_v1_founding_transfer_offers__nft_token_id__get
      parameters:
      - name: nft_token_id
        in: path
        required: true
        schema:
          type: string
          title: Nft Token Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/transfer/sync:
    post:
      summary: Transfer Sync
      description: 'Reconcile a founding name''s receive address with on-chain NFT ownership.


        After a transfer — ours or an off-API marketplace sale — the NFT holder changes but

        our DB cache can go stale. This reads the current holder from the ledger (source of

        truth for the founding tier) and updates the receive address so the name resolves to

        the new holder. The genesis-minter field (founding_xrpl_address) stays immutable.


        Provide expected_owner to confirm via AccountNFTs (works on any node); omit it to

        read the owner via Clio nft_info. Idempotent — safe to call repeatedly.'
      operationId: transfer_sync_api_v1_founding_transfer_sync_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferSyncRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
  /api/v1/founding/gallery:
    get:
      summary: Founding Gallery
      description: Public gallery of all completed founding aliases with their fractal identities.
      operationId: founding_gallery_api_v1_founding_gallery_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Founding
  /api/v1/founding/xrpl-balance/{xrpl_address}:
    get:
      summary: Check XRPL account balance and reserve safety for NFT claim
      description: 'Return an account''s XRP balance and whether it has enough to accept an NFT offer.


        Used by the claim page to warn users before they hit tecINSUFFICIENT_RESERVE.

        Safe to call unauthenticated — only reads public ledger data.'
      operationId: xrpl_balance_api_v1_founding_xrpl_balance__xrpl_address__get
      parameters:
      - name: xrpl_address
        in: path
        required: true
        schema:
          type: string
          title: Xrpl Address
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Founding
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    CreatePaymentRequest:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
        xrpl_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Xrpl Address
          description: If provided, the backend checks wallet_exists before creating the payload — prevents Xaman from requesting a payment from a wallet that is already registered.
      type: object
      required:
      - alias_name
      title: CreatePaymentRequest
    TransferSyncRequest:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
        expected_owner:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Expected Owner
      type: object
      required:
      - alias_name
      title: TransferSyncRequest
    TransferOfferRequest:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
        destination:
          type: string
          maxLength: 64
          minLength: 1
          title: Destination
        amount_drops:
          type: string
          maxLength: 20
          title: Amount Drops
          default: '0'
      type: object
      required:
      - alias_name
      - destination
      title: TransferOfferRequest
    TransferAcceptRequest:
      properties:
        offer_id:
          type: string
          maxLength: 128
          minLength: 1
          title: Offer Id
        alias_name:
          anyOf:
          - type: string
            maxLength: 128
          - type: 'null'
          title: Alias Name
      type: object
      required:
      - offer_id
      title: TransferAcceptRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ClaimNFTRequest:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
      type: object
      required:
      - alias_name
      title: ClaimNFTRequest
    FoundingAliasCreate:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
        xrpl_address:
          type: string
          maxLength: 34
          minLength: 25
          title: Xrpl Address
        founding_tx_hash:
          type: string
          maxLength: 64
          minLength: 64
          title: Founding Tx Hash
        preferred_rail:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          title: Preferred Rail
      type: object
      required:
      - alias_name
      - xrpl_address
      - founding_tx_hash
      title: FoundingAliasCreate
      description: Request body for POST /api/v1/founding/register — allows single-label aliases.
    BurnNFTRequest:
      properties:
        alias_name:
          type: string
          maxLength: 128
          minLength: 5
          title: Alias Name
      type: object
      required:
      - alias_name
      title: BurnNFTRequest
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key