Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nonhumans.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your agent can hold money, spend money, and get paid — without routing every transaction through a human. The wallet primitive gives your agent a multi-currency fiat account alongside stablecoin and crypto balances, all accessible through a single API. Every transaction is logged against your agent’s verified identity.
The wallet primitive moves real money. Always build and test your payment logic in the sandbox environment before switching to production credentials. Sandbox transactions are simulated and carry no financial risk.

​
What the Wallet Provides

Fiat Balances

Hold USD and EUR in a custodial account. Receive bank transfers and pay out to counterparties.

Stablecoins & Crypto

Native addresses for USDC, ETH, SOL, and more. Send and receive on-chain without managing private keys manually.

Multi-Network Support

Send USDC on Ethereum, Solana, or Base — specify the network at send time to control fees and settlement speed.

Unified Balance View

A single balance() call returns all fiat and crypto holdings in a structured response, so your agent always knows what it has available.

​
Supported Assets

AssetType
USDFiat
EURFiat
USDCStablecoin
ETHCrypto
SOLCrypto

​
Checking Balances

agent.wallet.balance() returns all fiat and crypto holdings in a single call. Fiat balances are grouped under fiat and crypto balances under crypto. 
import { Nonhumans } from '@nonhumans/sdk';

const agent = new Nonhumans({ apiKey: process.env.NONHUMANS_API_KEY });

const balances = await agent.wallet.balance();

console.log(balances.fiat.usd);    // "1042.50"
console.log(balances.fiat.eur);    // "890.00"
console.log(balances.crypto.usdc); // "500.00"
console.log(balances.crypto.eth);  // "0.142"
console.log(balances.crypto.sol);  // "12.75"

​
Sending Payments

Use agent.wallet.send() to transfer funds. Specify the recipient address, amount, asset, and — for on-chain transfers — the network. 
import { Nonhumans } from '@nonhumans/sdk';

const agent = new Nonhumans({ apiKey: process.env.NONHUMANS_API_KEY });

const tx = await agent.wallet.send({
  to: "0xRecipientAddress...",     // wallet address or agent handle
  amount: "50.00",
  asset: "USDC",
  network: "base",                 // "ethereum" | "solana" | "base"
});

console.log(tx.hash);    // on-chain transaction hash
console.log(tx.status);  // "pending" | "confirmed" | "failed"
​
to
string
required
Recipient wallet address or agent handle (e.g. bob.nonhumans.ai). When you send to an agent handle, the platform resolves the correct wallet address automatically.
​
amount
string
required
Amount to send as a decimal string (e.g. "50.00").
​
asset
string
required
Asset to send. One of USD, EUR, USDC, ETH, or SOL.
​
network
string
Network for on-chain transfers. One of ethereum, solana, or base. Required when sending crypto or stablecoin assets.
You can send to another agent’s handle directly — to: "bob.nonhumans.ai" — and the platform resolves the correct wallet address automatically. This makes agent-to-agent payments as simple as sending an email.

​
Use Cases

Autonomous Purchasing

Your agent can pay for API credits, SaaS subscriptions, or freelance work without requiring a human to approve each transaction.

Agent-to-Agent Payments

Agents from different operators can settle payments directly using handles, with no shared payment credentials required.

On-Chain Settlements

Send USDC or ETH on-chain for transparent, auditable settlements — useful for contracts that require a verifiable payment record.

Multi-Currency Operations

Hold USD for domestic payments and USDC for cross-border transfers — the wallet manages both without separate accounts.