Agentic Wallets

Agentic Wallets give AI agents their own self-custodial crypto wallets. Each wallet is a programmable spending account that AI services can use to send payments, pay for x402 paywalled APIs, and keep an immutable audit trail of every dollar spent. Built for the agentic economy — where AI agents need to pay for services, tools, and data autonomously.

How It Works

Create a wallet

Create an agentic wallet from the dashboard or via API. Each wallet gets its own on-chain address with USDC funding support.

Activate with 2FA

Activate the wallet using email OTP and/or TOTP verification. This ensures only the wallet owner can authorize the wallet for agent use.

Add connectors

Generate API keys (connectors) that your AI agent uses to authenticate. Each connector can have its own spending limits and permissions.

Fund the wallet

Deposit USDC into the wallet’s on-chain address, or use the manual funding endpoint to top up from your main account.

Let your agent transact

The agent uses its connector API key to send payments, pay for x402 APIs, and check balances — all with per-transaction audit trails.

Key Features

Per-Agent API Keys

Each connector gets a unique API key (yac_...) with configurable spending limits. Revoke a connector without affecting the wallet.

x402 Protocol Support

Built-in support for the x402 payment protocol. Your agent can fetch paywalled APIs and the wallet auto-pays the 402 response.

Spending Limits

Set per-transaction, daily, and monthly limits at the wallet level and per connector. Enforce budget controls before the agent can overspend.

Full Audit Trail

Every transaction records the service name, URL, payment reason, and category. Built for compliance and cost attribution.

Auto-Funding

Configure automatic top-ups when the wallet balance drops below a threshold. Funds are pulled from your main account.

Multi-Chain Support

Wallets support USDC across multiple chains. Pay services on any supported network.

Wallet Lifecycle

Status	Description
`created`	Wallet exists but cannot transact until activated
`activating`	OTP verification in progress
`active`	Fully operational — agents can transact
`suspended`	Temporarily halted by admin (e.g., suspicious activity)
`deactivated`	Permanently disabled by the owner

Connectors

Connectors are API keys tied to a specific wallet. Think of them as “agent credentials” — each AI agent or service integration gets its own connector, with its own limits and capabilities.

Field	Description
`connector_type`	`anthropic`, `openai`, `polymarket`, `kalshi`, `openclaw` or `custom`
`name`	Human-readable label (e.g., “Production Agent”)
`api_key`	Starts with `yac_`. Returned once, when the connector is created
`max_per_transaction`	Max USD amount per transaction
`max_daily_amount`	Max USD amount per day
`max_monthly_amount`	Max USD amount per month
`allowed_capabilities`	What the agent may do: `transfer`, `x402`, `prediction_market`. Defaults to `transfer` only
`allowed_assets`, `allowed_chains`	Optional allow-lists
`allowed_ips`, `allowed_domains`	Optional request origin allow-lists
`prediction_market_config`	Extra limits for prediction market trades. See Prediction markets

Limits must be consistent: max_per_transaction can’t exceed max_daily_amount, which can’t exceed max_monthly_amount. Any limit you leave out falls back to the wallet’s global limit. You can have multiple connectors per wallet for different agents or environments.

Capabilities

Every connector has an explicit list of capabilities. A request outside that list is rejected.

Capability	Allows
`transfer`	`POST /agent/transact` payments
`x402`	`POST /agent/x402-fetch` paid requests
`prediction_market`	Searching and trading prediction markets

New connectors get transfer only. Add x402 or prediction_market deliberately when you create or update the connector.

Agent API

Once a connector is active, the agent authenticates with its API key (Authorization: Bearer yac_...) and calls the Agent API directly:

Endpoint	Capability	Description
`GET /agent/openapi.json`	—	Machine-readable description of the Agent API. No auth
`GET /agent/capabilities`	—	What this connector can do, its limits and remaining budget
`POST /agent/transact`	`transfer`	Send a crypto payment
`GET /agent/balance`	—	Check wallet balance
`GET /agent/transactions`	—	List recent transactions
`POST /agent/x402-fetch`	`x402`	Fetch a URL with automatic x402 payment
`GET /agent/markets/search`	`prediction_market`	Search prediction markets
`POST /agent/markets/trade`	`prediction_market`	Buy or sell a market position
`GET /agent/positions`	`prediction_market`	List open positions

The Agent API allows 30 requests per minute.

Discover capabilities

Agents can check what they’re allowed to do before acting:

curl 'https://crypto-api.yativo.com/api/v1/agent/capabilities?wallet_id=aw_01abc123' \
  -H 'Authorization: Bearer yac_...'

{
  "success": true,
  "data": {
    "wallet_id": "aw_01abc123",
    "wallet_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "chain": "solana",
    "balance": 248.5,
    "capabilities": ["transfer", "prediction_market"],
    "limits": {
      "max_per_transaction": 50,
      "max_daily_amount": 500,
      "max_monthly_amount": 5000,
      "remaining_daily": 420,
      "remaining_monthly": 4780,
      "allowed_assets": [],
      "allowed_chains": []
    },
    "prediction_market": {
      "max_position_usd": 25,
      "allowed_categories": [],
      "allowed_providers": []
    },
    "supported_assets": ["..."]
  }
}

GET /agent/openapi.json returns an OpenAPI description of the same surface, so any OpenAPI-aware agent framework (LangChain, GPT Actions, custom code) can discover it.

Send a Payment

curl -X POST 'https://crypto-api.yativo.com/api/v1/agent/transact' \
  -H 'Authorization: Bearer yac_connector_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_id": "aw_01abc123",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
    "service_name": "OpenAI API",
    "service_url": "https://api.openai.com",
    "payment_reason": "GPT-4 inference for customer support bot",
    "payment_category": "ai_service"
  }'

Response

{
  "success": true,
  "data": {
    "transaction_id": "atx_01pqr456",
    "tx_hash": "0xabc123...",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b...",
    "chain": "base",
    "status": "completed",
    "fee": 0.00,
    "is_free_transaction": true
  }
}

x402 Protocol Fetch

The x402 protocol enables HTTP-native micropayments. When your agent fetches a URL that returns HTTP 402 (Payment Required), the wallet automatically pays and retries:

curl -X POST 'https://crypto-api.yativo.com/api/v1/agent/x402-fetch' \
  -H 'Authorization: Bearer yac_connector_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_id": "aw_01abc123",
    "url": "https://api.example.com/premium-data",
    "method": "GET"
  }'

Response

{
  "success": true,
  "data": {
    "status": 200,
    "paid": true,
    "payment": {
      "amount_usd": 0.01,
      "asset": "USDC",
      "network": "base",
      "pay_to": "0x..."
    },
    "body": { "premium_data": "..." }
  }
}

Prediction markets

Connectors with the prediction_market capability can trade prediction markets from a Solana agentic wallet, paying in USDC. Every trade goes through the same limits and rules as a payment, and a trade that would move more USDC than authorized is refused. Search markets

curl 'https://crypto-api.yativo.com/api/v1/agent/markets/search?wallet_id=aw_01abc123&query=election&limit=10' \
  -H 'Authorization: Bearer yac_...'

Query param	Description
`wallet_id`	Required. The agentic wallet
`query`	Search text
`category`	Filter by category
`limit`	Max results (default 20)
`provider`	Optional. Leave out to use the default

Place a trade

curl -X POST 'https://crypto-api.yativo.com/api/v1/agent/markets/trade' \
  -H 'Authorization: Bearer yac_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: trade-7f3a' \
  -d '{
    "wallet_id": "aw_01abc123",
    "market_id": "MARKET_ID_FROM_SEARCH",
    "outcome": "yes",
    "side": "buy",
    "amount": 10,
    "category": "politics",
    "reason": "Agent strategy signal"
  }'

Field	Required	Description
`wallet_id`	Yes	The agentic wallet
`market_id`	Yes	From market search
`outcome`	Yes	`yes` or `no`
`side`	No	`buy` (default) or `sell`
`amount`	Yes	USD notional, paid in USDC
`category`	Only if the connector limits categories	The market’s category
`reason`, `metadata`	No	Stored with the transaction for your records

Send an Idempotency-Key header (or idempotency_key field) so a retried trade isn’t placed twice. Trade limits (set per connector in prediction_market_config):

max_position_usd — largest single trade.
allowed_categories — if set, trades must name one of these categories.
allowed_providers — if set, only these providers can be used.

List positions

curl 'https://crypto-api.yativo.com/api/v1/agent/positions?wallet_id=aw_01abc123' \
  -H 'Authorization: Bearer yac_...'

Payment Categories

Every agent transaction requires a payment_category for audit and analytics:

Category	Use Case
`ai_service`	Paying for AI model inference, embeddings, etc.
`prediction_market`	Placing bets or funding prediction contracts
`legal_escrow`	Escrow payments for legal or contractual obligations
`subscription`	Recurring service subscriptions
`purchase`	One-time purchases or API credits
`transfer`	Wallet-to-wallet transfers
`settlement`	Settling invoices or outstanding balances
`other`	Anything not covered above

Pricing

Agentic wallet pricing is tier-based. Check the current pricing:

curl -X GET 'https://crypto-api.yativo.com/api/v1/agentic-wallets/pricing' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Each plan includes a number of free transactions per month. Transactions beyond the free tier incur a small per-transaction fee.

Next Steps

API Reference

Full endpoint reference for all agentic wallet operations.

Sandbox

Test agentic wallets in the sandbox environment.

Webhooks

Get notified on agent transaction events.

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

Automation

Compliance

B2B

Developer Tools

Tutorials

Sandbox

Agentic Wallets

How It Works

Key Features

Per-Agent API Keys

x402 Protocol Support

Spending Limits

Full Audit Trail

Auto-Funding

Multi-Chain Support

Wallet Lifecycle

Connectors

Capabilities

Agent API

Discover capabilities

Send a Payment

x402 Protocol Fetch

Prediction markets

Payment Categories

Pricing

Next Steps

API Reference

Sandbox

Webhooks

​How It Works

​Key Features

Per-Agent API Keys

x402 Protocol Support

Spending Limits

Full Audit Trail

Auto-Funding

Multi-Chain Support

​Wallet Lifecycle

​Connectors

​Capabilities

​Agent API

​Discover capabilities

​Send a Payment

​x402 Protocol Fetch

​Prediction markets

​Payment Categories

​Pricing

​Next Steps

API Reference

Sandbox

Webhooks

How It Works

Key Features

Wallet Lifecycle

Connectors

Capabilities

Agent API

Discover capabilities

Send a Payment

x402 Protocol Fetch

Prediction markets

Payment Categories

Pricing

Next Steps