Skip to content
Minotaur
+ 05 · API Reference

API · Wallets

Managed-wallet provisioning, balance reads, and per-app funding.

All endpoints below are mounted under /v1 on the validator API (https://api.minotaursubnet.com). The CORS allowlist covers https://app.minotaursubnet.com.

POST /v1/apps/{app_id}/fund

Deposit tokens into an App Intent’s contract.

Path parameters

  • app_idstr (required)

Request body

  • bodyFundWalletRequest (required) (model FundWalletRequest)
    • token: str = Field(..., description='Token address (plain 0x or CAIP-10)')
    • amount: str = Field(..., description='Amount in wei (decimal string)')
    • chain_id: int = Field(..., description='Target chain ID')
    • depositor: str = Field('', description='User address to credit the deposit to (for DCA-style apps)')

GET /v1/wallets/

List all managed wallets.

POST /v1/wallets/

Create a new managed wallet.

Request body

  • bodyCreateWalletRequest (required) (model CreateWalletRequest)
    • chain_ids: list[int] = Field(..., description='Chain IDs to support')

GET /v1/wallets/{address:path}

Look up wallet information by address (plain 0x or CAIP-10).

Path parameters

  • addressstr (required)

GET /v1/wallets/{address}/balances

Query ETH + ERC-20 balances for an address. Works for any address.

Path parameters

  • addressstr (required)

Query parameters

  • chain_idint