> ## Documentation Index > Fetch the complete documentation index at: https://docs.simpuru.xyz/llms.txt > Use this file to discover all available pages before exploring further. # My account > Wallet balance, agent limits, what I bought (from my wallet or my Simpuru wallet), what I sell, and my seller reputation. ## OpenAPI ````yaml https://api.simpuru.xyz/openapi.json get /me openapi: 3.1.0 info: title: Simpuru API version: 0.1.0 summary: Buyer protection for AI agents paying with x402 on Cardano (preprod). description: >- Sellers list design prompts; each listing commits to the SHA-256 of its content. Buyers (people or agents) pay over **x402** on Cardano preprod, either **instant** (pay the seller) or **protected** (lock into our `vested_pay` escrow, released only if delivery checks out). Consumers: the web app (`apps/web`), the buyer agent and protection watcher (`apps/agent`), the MCP server (`apps/mcp`, hosted at `/mcp`), and the arbiter service (`apps/arbiter`, internal). Every on-chain claim can be checked on `https://preprod.cardanoscan.io/transaction/`. license: name: MIT identifier: MIT servers: - url: https://api.simpuru.xyz description: Production (Cardano preprod) - url: http://localhost:4021 description: Local `bun run dev` in apps/api security: [] tags: - name: Account description: >- Sign in with a Cardano wallet (CIP-30 `signData`), then use the session as `Authorization: Bearer `. Every account has a Simpuru wallet: a preprod wallet the platform holds for the owner, funded with tADA, that web purchases and the owner's agents spend from. - name: Catalogue description: Free listing data. - name: Paid content description: 'The x402 paywall: instant or escrow-protected.' - name: Purchases description: Purchase timelines, derived from chain by the seller agent. - name: MCP description: Model Context Protocol endpoint for agents (Claude Code, Cursor, ...). - name: Arbiter (internal) description: Dispute settlement service, `apps/arbiter`, port 4023. Not public. - name: System description: Health. paths: /me: get: tags: - Account summary: My account description: >- Wallet balance, agent limits, what I bought (from my wallet or my Simpuru wallet), what I sell, and my seller reputation. operationId: getMe responses: '200': description: Account content: application/json: schema: $ref: '#/components/schemas/Me' '401': description: Not signed in content: application/json: schema: $ref: '#/components/schemas/Error' security: - session: [] components: schemas: Me: type: object properties: owner: type: string description: The wallet I signed in with. wallet: type: object description: My Simpuru wallet. properties: address: type: string balanceLovelace: type: string pattern: ^[0-9]+$ description: Amount in lovelace (1 tADA = 1,000,000). required: - address - balanceLovelace limits: type: object properties: maxPerPaymentLovelace: type: string pattern: ^[0-9]+$ description: Amount in lovelace (1 tADA = 1,000,000). dailyBudgetLovelace: type: string pattern: ^[0-9]+$ description: Amount in lovelace (1 tADA = 1,000,000). spentTodayLovelace: type: string pattern: ^[0-9]+$ description: Amount in lovelace (1 tADA = 1,000,000). required: - maxPerPaymentLovelace - dailyBudgetLovelace - spentTodayLovelace purchases: type: array items: $ref: '#/components/schemas/Purchase' listings: type: array items: $ref: '#/components/schemas/Listing' sales: type: integer sellerReputation: type: object properties: score: type: integer basis: type: integer required: - owner - wallet - limits - purchases - listings - sales Error: type: object properties: error: type: string required: - error Purchase: type: object properties: id: type: string pattern: ^[0-9a-f]{64}$ description: Payment tx (instant) or lock tx (protected). listingId: type: string mode: $ref: '#/components/schemas/DeliveryMode' buyerAddress: type: string txHash: type: string pattern: ^[0-9a-f]{64}$ description: Cardano transaction hash. status: type: string description: >- Escrow state (FundsLocked, ResultSubmitted, RefundRequested, Disputed, WithdrawAuthorized, RefundAuthorized) or a final state (settled, withdrawn, refunded, closed). `withdrawing` while the seller agent collects. escrow: type: object properties: address: type: string inputHash: type: string pattern: ^[0-9a-f]{64}$ description: Lowercase hex SHA-256. resultHash: type: string pattern: ^[0-9a-f]{64}$ description: Lowercase hex SHA-256. identifierFromPurchaser: type: string pattern: ^[0-9a-f]{64}$ description: 'Team convention: the lock tx hash.' deadlines: $ref: '#/components/schemas/EscrowDeadlines' events: type: array items: $ref: '#/components/schemas/PurchaseEvent' verification: $ref: '#/components/schemas/Verification' required: - id - listingId - mode - buyerAddress - txHash - status - events Listing: type: object properties: id: type: string title: type: string description: type: string priceLovelace: type: string pattern: ^[0-9]+$ description: Amount in lovelace (1 tADA = 1,000,000). sellerAddress: type: string description: Preprod address that sells (and, instant, gets paid). modes: type: array items: $ref: '#/components/schemas/DeliveryMode' contentHash: type: string pattern: ^[0-9a-f]{64}$ description: SHA-256 of the content the buyer receives. previewMedia: type: string format: uri description: Free https recording of what the prompt builds. category: $ref: '#/components/schemas/Category' createdAt: type: string description: Unix ms. sales: type: integer description: Purchases that were not refunded. sellerReputation: type: object description: >- From the seller's closed escrows: 100 × withdrawn / (withdrawn + refunded). Absent until one. properties: score: type: integer minimum: 0 maximum: 100 basis: type: integer required: - score - basis required: - id - title - description - priceLovelace - sellerAddress - modes - contentHash DeliveryMode: type: string enum: - instant - protected EscrowDeadlines: type: object description: Unix ms strings. properties: payBy: type: string submitResult: type: string unlock: type: string externalDisputeUnlock: type: string PurchaseEvent: type: object properties: status: type: string txHash: type: string pattern: ^[0-9a-f]{64}$ description: Cardano transaction hash. at: type: string description: Unix ms. required: - status - txHash - at Verification: type: string enum: - ok - mismatch - no_result_yet Category: type: string enum: - Landing Page - Hero - Portfolio - SaaS - Fintech - 3D - AI - Editorial - Wellness securitySchemes: session: type: http scheme: bearer description: Session token from `POST /auth/verify` (7 days). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.