# Cobo Agentic Wallet

## Docs

- [Agno](https://cobo.com/products/agentic-wallet/manual/developer/agno.md): 5-minute Agno quickstart with pact submission and denial-aware tool behavior.
- [Python SDK](https://cobo.com/products/agentic-wallet/manual/developer/api-client-python.md): Canonical 5-minute Python SDK quickstart: submit a pact, transfer tokens, handle policy denial, and verify in audit logs.
- [Audit and Activity Logs](https://cobo.com/products/agentic-wallet/manual/developer/audit.md): Query the audit trail and subscribe to real-time events.
- [Batch Operations and Transaction Management](https://cobo.com/products/agentic-wallet/manual/developer/batch-operations.md): Submit batch transfers, speed up or drop stuck transactions, and use request_id for idempotency.
- [Changelog](https://cobo.com/products/agentic-wallet/manual/developer/changelog.md): Version history for Cobo Agentic Wallet — service and SDK.
- [CLI](https://cobo.com/products/agentic-wallet/manual/developer/cli.md): Set up and operate a wallet from the terminal using the caw CLI.
- [CrewAI](https://cobo.com/products/agentic-wallet/manual/developer/crewai.md): 5-minute CrewAI quickstart with pact submission and policy-aware transfer execution.
- [Custom Skill](https://cobo.com/products/agentic-wallet/manual/developer/custom-skill.md): Add the Cobo Agentic Wallet skill to your agent — no code required.
- [Features](https://cobo.com/products/agentic-wallet/manual/developer/features.md): What Cobo Agentic Wallet gives your agent — and what it enforces on your behalf.
- [Glossary](https://cobo.com/products/agentic-wallet/manual/developer/glossary.md): Key terms and definitions for Cobo Agentic Wallet.
- [Guide Your Users Through Onboarding](https://cobo.com/products/agentic-wallet/manual/developer/guide-users.md): How to walk your users through connecting an agent to Cobo Agentic Wallet using the Human App.
- [Handle Policy Denial](https://cobo.com/products/agentic-wallet/manual/developer/handle-policy-denial.md): Parse structured denials and implement self-correcting retry loops.
- [Integration Modes](https://cobo.com/products/agentic-wallet/manual/developer/integration-modes.md): Three ways to integrate Cobo Agentic Wallet — Agent Mode, Core Mode, and Owner Mode.
- [LangChain](https://cobo.com/products/agentic-wallet/manual/developer/langchain.md): 5-minute LangChain quickstart with pact submission and denial-aware retries.
- [Manage Wallets and Addresses](https://cobo.com/products/agentic-wallet/manual/developer/manage-wallet.md): Create wallets, add addresses, check balances, and manage wallet lifecycle.
- [MCP Server](https://cobo.com/products/agentic-wallet/manual/developer/mcp.md): 5-minute MCP Server quickstart with stdio server, pact submission, policy denial, and self-correction.
- [MPC Security Model](https://cobo.com/products/agentic-wallet/manual/developer/mpc-security.md): How Cobo Agentic Wallet uses threshold signing to protect wallet keys — technical details for developers.
- [OpenAI Agents SDK](https://cobo.com/products/agentic-wallet/manual/developer/openai.md): 5-minute OpenAI Agents SDK quickstart with pact submission and policy denial feedback.
- [Pact Lifecycle](https://cobo.com/products/agentic-wallet/manual/developer/pact-lifecycle.md): How pacts move through states — from submission to expiry — and how they create delegations and API keys.
- [Submit and Manage Pacts](https://cobo.com/products/agentic-wallet/manual/developer/pacts.md): How to use pacts for task-level authorization — submit, poll, operate, and revoke.
- [Integrate Wallet Into Your Agent](https://cobo.com/products/agentic-wallet/manual/developer/quickstart-overview.md): Compare integration paths and choose the right one for your agent.
- [Supported chains](https://cobo.com/products/agentic-wallet/manual/developer/supported-chains.md): Cobo chain IDs for all chains supported by Cobo Agentic Wallet.
- [Technical Architecture](https://cobo.com/products/agentic-wallet/manual/developer/technical-architecture.md): How the Cobo Agentic Wallet service, SDK, human interfaces, and agent integrations fit together.
- [Transfer and Contract Calls](https://cobo.com/products/agentic-wallet/manual/developer/transact.md): Submit transfers and contract calls, estimate fees, and handle pending approval responses.
- [View Balance and Activity](https://cobo.com/products/agentic-wallet/manual/get-started/activity.md): Check your wallet balance and review your agent's transaction history from the Human App.
- [Review and approve pacts](https://cobo.com/products/agentic-wallet/manual/get-started/approve.md): How to handle pacts from your agent — when it wants to take on a new task on your behalf.
- [Pair Your Agent](https://cobo.com/products/agentic-wallet/manual/get-started/connect-agent-human-app.md): Pair your agent with the Human App from your phone. Once paired, you set the rules and your agent operates within your limits.
- [Features](https://cobo.com/products/agentic-wallet/manual/get-started/features.md): What Cobo Agentic Wallet does for you as a wallet owner — pact-first authorization, deep policy enforcement, and MPC security.
- [Pause or revoke agent access](https://cobo.com/products/agentic-wallet/manual/get-started/freeze.md): How to immediately stop your agent from moving funds — temporarily or permanently.
- [The Human App](https://cobo.com/products/agentic-wallet/manual/get-started/human-app.md): Your primary interface for owning, managing, and controlling your wallet from your phone.
- [Introduction](https://cobo.com/products/agentic-wallet/manual/get-started/introduction.md): The most secure way for AI agents to manage crypto — because every agent operates through a pact.
- [Key concepts](https://cobo.com/products/agentic-wallet/manual/get-started/key-concepts.md): The core ideas behind Cobo Agentic Wallet — what each part is, what it does, and how they work together.
- [Pact flow](https://cobo.com/products/agentic-wallet/manual/get-started/pact-flow.md): The end-to-end picture: how one pact moves from your intent, through your agent's draft, through your approval in the Human App, into bounded on-chain execution, and back out to a clean revocation.
- [Handle transactions](https://cobo.com/products/agentic-wallet/manual/get-started/pending-ops.md): Understand transaction statuses and act on transactions that need your attention — approvals, blockages, and stuck on-chain transactions.
- [Set rules and limits](https://cobo.com/products/agentic-wallet/manual/get-started/policies.md): Control what your agent can spend, where it can send funds, and when transactions need your approval.
- [ABIs and calldata](https://cobo.com/products/agentic-wallet/manual/learn/abi-calldata.md): How function selectors and ABI encoding work, and how to generate calldata for Cobo contract calls.
- [AI-specific risks](https://cobo.com/products/agentic-wallet/manual/learn/ai-specific-risks.md): Prompt injection, adversarial contracts, model hallucination, and how Cobo's architecture mitigates AI-specific attack vectors.
- [The autonomy spectrum](https://cobo.com/products/agentic-wallet/manual/learn/autonomy-spectrum.md): From fully manual to fully autonomous — how to choose the right level of agent independence for your use case.
- [Chains and chain IDs](https://cobo.com/products/agentic-wallet/manual/learn/chains.md): How blockchains are identified — EVM chain IDs, Cobo chain IDs, and which chains Cobo Agentic Wallet supports.
- [Common DeFi protocol interfaces](https://cobo.com/products/agentic-wallet/manual/learn/common-protocols.md): Function signatures and interaction patterns for Uniswap v3, Aave v3, Curve, and ERC-20.
- [What is DeFi](https://cobo.com/products/agentic-wallet/manual/learn/defi-overview.md): The key primitives in decentralized finance — and what risks agents need to account for.
- [Delegated authority model](https://cobo.com/products/agentic-wallet/manual/learn/delegated-authority.md): What a Pact represents, how AI delegation differs from an API key, and how owners retain control through policy.
- [ERC-20 approvals](https://cobo.com/products/agentic-wallet/manual/learn/erc20-approvals.md): Why DeFi protocols require an approve step before interacting, and how the allowance model works.
- [Lending and borrowing](https://cobo.com/products/agentic-wallet/manual/learn/lending-borrowing.md): How collateral-based lending works in DeFi, health factors, and liquidation risk.
- [Liquidity pools and AMMs](https://cobo.com/products/agentic-wallet/manual/learn/liquidity-pools.md): How AMM liquidity pools work, LP tokens, concentrated liquidity, and impermanent loss.
- [Multi-agent trust](https://cobo.com/products/agentic-wallet/manual/learn/multi-agent-trust.md): How trust and authority work when one agent delegates to another — orchestrator patterns, scoped key inheritance, and trust hierarchy design.
- [Concepts](https://cobo.com/products/agentic-wallet/manual/learn/overview.md): Blockchain and DeFi concepts your agent needs to operate — from chain IDs and tokens to swap contracts and lending protocols.
- [Policy-first design](https://cobo.com/products/agentic-wallet/manual/learn/policy-first-design.md): Why you design safe agent behavior through constraints rather than trust — and how to apply the principle of least privilege to AI.
- [Smart contracts](https://cobo.com/products/agentic-wallet/manual/learn/smart-contracts.md): What smart contracts are, how to read and call them, and what ABIs and events are.
- [Staking](https://cobo.com/products/agentic-wallet/manual/learn/staking.md): Protocol staking, liquid staking, and auto-compounding agent patterns.
- [Testnets](https://cobo.com/products/agentic-wallet/manual/learn/testnets.md): How to develop and test on Sepolia and Solana Devnet before deploying to mainnet.
- [Token swaps (DEX)](https://cobo.com/products/agentic-wallet/manual/learn/token-swaps.md): How automated market makers work, slippage, and how to build swap agents.
- [Tokens and token standards](https://cobo.com/products/agentic-wallet/manual/learn/tokens.md): Native tokens, ERC-20, SPL, and how Cobo token IDs are formatted.
- [Transactions and gas](https://cobo.com/products/agentic-wallet/manual/learn/transactions.md): How on-chain transactions work, what gas fees are, and how Cobo Gasless handles them automatically.
- [Wallets and addresses](https://cobo.com/products/agentic-wallet/manual/learn/wallets.md): What wallet addresses and private keys are, and how MPC wallets protect key material.
- [What is a pact](https://cobo.com/products/agentic-wallet/manual/learn/what-is-a-pact.md): A pact is a structured delegation agreement between you and your agent — with intent, execution plan, policies, and completion conditions. Enforced by infrastructure, not trust.
- [What is an agentic wallet](https://cobo.com/products/agentic-wallet/manual/learn/what-is-agentic-wallet.md): How agentic wallets differ from EOA wallets, multisigs, and smart contract wallets — and why AI-as-principal is a fundamentally new paradigm.
- [Agent-to-Agent Commerce](https://cobo.com/products/agentic-wallet/manual/recipes/agent-to-agent.md): Gate autonomous settlement on delivery proof with payout caps and destination controls.
- [API Micropayment](https://cobo.com/products/agentic-wallet/manual/recipes/api-micropayment.md): Low-value autonomous API payments with strict per-tx and daily guardrails.
- [DCA Trader](https://cobo.com/products/agentic-wallet/manual/recipes/dca-trader.md): Build a dollar-cost averaging agent with time-window and cumulative spend policies.
- [DeFi Yield Optimizer](https://cobo.com/products/agentic-wallet/manual/recipes/defi-yield-optimizer.md): Auto-rebalance DeFi positions with protocol/function allowlists and parameter-safe guardrails.
- [Discord Tip Bot](https://cobo.com/products/agentic-wallet/manual/recipes/discord-tip-bot.md): Build a Discord tipping bot with strict transfer policies and denial-aware self-correction.
- [Emergency Kill Switch](https://cobo.com/products/agentic-wallet/manual/recipes/emergency-kill-switch.md): Freeze all delegations instantly and force owner re-authorization before agents can move funds.
- [Lending Rate Arbitrage](https://cobo.com/products/agentic-wallet/manual/recipes/lending-arbitrage.md): Move lending positions to lower-rate platforms automatically.
- [Org Payroll](https://cobo.com/products/agentic-wallet/manual/recipes/org-payroll.md): Automate payroll with tiered delegations, approval thresholds, recipient allowlists, and monthly budget enforcement.
- [Agent Recipes](https://cobo.com/products/agentic-wallet/manual/recipes/overview.md): Real-world examples and tutorials organized by use case
- [Prediction Market](https://cobo.com/products/agentic-wallet/manual/recipes/prediction-market.md): Event-driven automated betting and settlement on Polymarket.
- [SaaS Subscription Renewal](https://cobo.com/products/agentic-wallet/manual/recipes/saas-subscription.md): Automatic recurring subscription renewal with low-balance alerts.
- [Streaming Payroll](https://cobo.com/products/agentic-wallet/manual/recipes/streaming-payroll.md): Real-time per-second salary payments using Superfluid streams.
- [Trading Execution](https://cobo.com/products/agentic-wallet/manual/recipes/trading-execution.md): Run execution bots with strict per-order risk caps and router destination allowlists.
- [Agno](https://cobo.com/products/agentic-wallet/manual/reference/agno.md): Integrate Cobo Agentic Wallet with Agno agents.
- [Approve pending operation](https://cobo.com/products/agentic-wallet/manual/reference/approve-pending-operation.md): This operation approves a pending operation and triggers its execution. The pending operation ID can be retrieved by calling the List pending operations operation. Only the wallet owner principal can approve pending operations. For unclaimed agent-owned wallets, the same agent principal is also the…
- [Archive wallet](https://cobo.com/products/agentic-wallet/manual/reference/archive-wallet.md): This operation archives a specific wallet. The wallet ID can be retrieved by calling the List all wallets operation. Archived wallets are excluded from list results by default and cannot be updated.
- [CLI](https://cobo.com/products/agentic-wallet/manual/reference/cli.md): Command-line interface for the Cobo Agentic Wallet SDK.
- [Report export completed](https://cobo.com/products/agentic-wallet/manual/reference/complete-export.md): Call this endpoint after your agent has successfully completed local MPC key share reconstruction. Marks the export status as `completed` and records the completion timestamp. Only call this endpoint once the reshare process has finished and the MPC key share material has been fully reconstructed lo…
- [Confirm wallet pairing](https://cobo.com/products/agentic-wallet/manual/reference/confirm-wallet-pair.md): This operation allows a human principal to confirm ownership pairing of an agent's wallet using the 8-digit pairing code generated by the Initiate wallet pairing operation. Pairing transfers wallet ownership to the human, creates a delegation granting the agent access, and links the agent to the hum…
- [Call contract](https://cobo.com/products/agentic-wallet/manual/reference/contract-call.md): This operation submits a smart contract call from the specified wallet.
- [Create API key](https://cobo.com/products/agentic-wallet/manual/reference/create-api-key.md): This operation creates a new API key for a principal.
- [Create delegation](https://cobo.com/products/agentic-wallet/manual/reference/create-delegation.md): This operation grants an operator access to a wallet on behalf of the authenticated principal.
- [Create key export request](https://cobo.com/products/agentic-wallet/manual/reference/create-export.md): Creates a new key export request for the specified wallet, or returns the existing in-flight export (pending_authorization, approved, resharing) if one already exists — idempotent POST so clients can resume without local state.
- [Create policy](https://cobo.com/products/agentic-wallet/manual/reference/create-policy.md): This operation creates a new policy for the authenticated principal.
- [Create principal](https://cobo.com/products/agentic-wallet/manual/reference/create-principal.md): This operation creates a new principal (a human or agent identity). Requires service credential authentication via `X-Service-Auth-Key`. If a principal with the same `external_id` already exists, the existing record is returned with `created=false` and HTTP 200.
- [Create wallet](https://cobo.com/products/agentic-wallet/manual/reference/create-wallet.md): This operation creates a new wallet for the authenticated principal.
- [Create wallet address](https://cobo.com/products/agentic-wallet/manual/reference/create-wallet-address.md): This operation derives a new on-chain address for the specified wallet and chain. The wallet ID can be retrieved by calling the List all wallets operation. Provide `chain_id` (Cobo metadata id, e.g. `SETH`) and/or `chain_identifier` (WaaS id such as `ETH`/`SOL`, or a resolvable Cobo id). If only `ch…
- [CrewAI](https://cobo.com/products/agentic-wallet/manual/reference/crewai.md): Integrate Cobo Agentic Wallet with CrewAI multi-agent workflows.
- [Deactivate policy](https://cobo.com/products/agentic-wallet/manual/reference/deactivate-policy.md): This operation deactivates a specific policy, excluding it from policy evaluation without deleting it. The policy ID can be retrieved by calling the List all policies operation. You can reactivate the policy by calling the Update policy operation with `is_active=true`.
- [Delete webhook registration](https://cobo.com/products/agentic-wallet/manual/reference/delete-webhook-registration.md): This operation deactivates a specific webhook registration. Requires service credential authentication via `X-Service-Auth-Key`. The registration ID is returned when registering a webhook.
- [Request faucet deposit](https://cobo.com/products/agentic-wallet/manual/reference/deposit.md): This operation sends testnet tokens to the specified wallet address. Provide `address` (an on-chain address registered to one of your wallets) and `token_id` (a token available from the faucet). Call the List faucet tokens operation to see available tokens.
- [Drop transaction](https://cobo.com/products/agentic-wallet/manual/reference/drop-transaction.md): This operation cancels or drops a pending transaction.
- [Dry-run policy](https://cobo.com/products/agentic-wallet/manual/reference/dry-run-policy.md): This operation evaluates policies against a hypothetical operation without submitting a transaction. Use it to preview the policy decision before performing a transfer or contract call.
- [Estimate contract call fee](https://cobo.com/products/agentic-wallet/manual/reference/estimate-contract-call-fee.md): This operation estimates the network fee for a contract call without submitting a transaction. You can use the returned `recommended`, `slow`, and `fast` fee options when constructing the contract call request. Policy evaluation runs before the estimate — the operation returns an error if a policy w…
- [Estimate transfer fee](https://cobo.com/products/agentic-wallet/manual/reference/estimate-transfer-fee.md): This operation estimates the network fee for a token transfer without submitting a transaction. You can use the returned `recommended`, `slow`, and `fast` fee options when constructing the transfer request. Policy evaluation runs before the estimate — the operation returns an error if a policy would…
- [Freeze delegations](https://cobo.com/products/agentic-wallet/manual/reference/freeze-delegations.md): This operation suspends one or more delegations, preventing the operator from performing any actions until the delegation is unfrozen.
- [Get agent status](https://cobo.com/products/agentic-wallet/manual/reference/get-agent-status.md): This operation retrieves the provisioning and activation status of a specific agent. The agent ID is returned as `agent_id` in the Provision agent response. Accepts either the internal UUID or the external ID. Requires authentication with the agent's own API key.
- [Get approval details](https://cobo.com/products/agentic-wallet/manual/reference/get-approval.md): Retrieve the full details of an approval request.
- [Get coin prices](https://cobo.com/products/agentic-wallet/manual/reference/get-asset-coin-prices.md): This operation retrieves the latest prices for the specified asset coins. Prices are sourced from a background-synced table and are eventually consistent. USDT is always priced at `1`. The response is a map of coin ID to price string.
- [Get chain info](https://cobo.com/products/agentic-wallet/manual/reference/get-chain-info-by-chain-id.md): This operation retrieves configuration details for a specific chain by its Cobo chain ID (for example, `ETH`, `BASE_ETH`, `SOL`). Returns the chain identifier, RPC URL, and other chain-level metadata stored locally. Obtain the full list of supported chain IDs by calling the List supported chains ope…
- [Get delegation](https://cobo.com/products/agentic-wallet/manual/reference/get-delegation.md): This operation retrieves a specific delegation by its ID. The delegation ID can be retrieved by calling the List delegations operation.
- [Get export status](https://cobo.com/products/agentic-wallet/manual/reference/get-export.md): Returns the current status and full details of a key export request. Poll this endpoint to track status transitions (e.g. `pending_authorization` → `approved` → `resharing` → `completed` or `rejected`). Pass the `wallet_uuid` and `export_id` returned when the export was created.
- [List AP2 merchants](https://cobo.com/products/agentic-wallet/manual/reference/get-merchants.md): Retrieve all AP2 merchants available in the system. Returns a list of merchant records, each containing the merchant's identifier and display information.
- [Get pact detail](https://cobo.com/products/agentic-wallet/manual/reference/get-pact.md): Retrieve pact details. The api_key field is only visible to the operator that submitted the pact.
- [Get pair info by token](https://cobo.com/products/agentic-wallet/manual/reference/get-pair-info.md): This operation retrieves pairing information by the 8-digit pairing code, including the agent and wallet details. No authentication is required - the code itself serves as the access credential.
- [Get pair info by wallet](https://cobo.com/products/agentic-wallet/manual/reference/get-pair-info-by-wallet.md): This operation retrieves the most recent pairing record for the specified wallet, including the associated agent and wallet details. Authentication is required. Use the wallet UUID obtained from the List all wallets operation.
- [Get pending operation](https://cobo.com/products/agentic-wallet/manual/reference/get-pending-operation.md): This operation retrieves a specific pending approval operation by its ID. The pending operation ID is returned in the `pending_operation_id` field when a transfer, contract call, or message sign returns `status=pending_approval`. Both human owners and the agent that initiated the operation can read…
- [Get policy](https://cobo.com/products/agentic-wallet/manual/reference/get-policy.md): This operation retrieves a specific policy by its ID. The policy ID can be retrieved by calling the List all policies operation.
- [Get full recipe document by ID](https://cobo.com/products/agentic-wallet/manual/reference/get-recipe-document.md)
- [Get telemetry config](https://cobo.com/products/agentic-wallet/manual/reference/get-telemetry-config.md): Return the CLI telemetry feature-flag configuration for your authenticated session.
- [Get transaction record](https://cobo.com/products/agentic-wallet/manual/reference/get-transaction-record.md): This operation retrieves a specific on-chain transaction record by its ID. The record ID can be retrieved by calling the List transaction records operation.
- [Get transaction record by request id](https://cobo.com/products/agentic-wallet/manual/reference/get-transaction-record-by-request-id.md): This operation retrieves a transaction record using the client-supplied idempotency key (`request_id`) scoped to the given wallet. Use the same `wallet_uuid` as for transfers and contract calls.
- [Get wallet](https://cobo.com/products/agentic-wallet/manual/reference/get-wallet.md): This operation retrieves detailed information about a specific wallet by its ID. The wallet ID can be retrieved by calling the List all wallets operation. When the caller is the wallet owner, the response includes a `spend_summary` array showing spending totals per delegation.
- [Get node status](https://cobo.com/products/agentic-wallet/manual/reference/get-wallet-node-status.md): This operation retrieves the online status of the TSS node associated with a specific wallet. The wallet ID can be retrieved by calling the List all wallets operation. The response indicates whether the node is currently online and available for signing.
- [Handle WaaS webhook](https://cobo.com/products/agentic-wallet/manual/reference/handle-waas-webhook.md): This endpoint receives webhook events from the Cobo WaaS platform and processes transaction status updates and balance changes. Requests must include valid `biz-timestamp` and `biz-resp-signature` headers for signature verification.
- [Health Check](https://cobo.com/products/agentic-wallet/manual/reference/health-check.md)
- [Ingest session telemetry](https://cobo.com/products/agentic-wallet/manual/reference/ingest-session-telemetry.md): Receive a session telemetry record that may contain nested child spans.
- [Ingest CLI telemetry record](https://cobo.com/products/agentic-wallet/manual/reference/ingest-telemetry.md): Receive a CLI telemetry record from your agent, extract structured fields, and forward them to Logstash/Kibana via structured logging and an OpenTelemetry span.
- [Initiate wallet pairing](https://cobo.com/products/agentic-wallet/manual/reference/initiate-wallet-pair.md): This operation generates an 8-digit pairing code that allows a human principal to pair ownership of an agent's wallet. The agent must own the wallet.
- [LangChain](https://cobo.com/products/agentic-wallet/manual/reference/langchain.md): Integrate Cobo Agentic Wallet with LangChain agents.
- [List API keys](https://cobo.com/products/agentic-wallet/manual/reference/list-api-keys.md): This operation retrieves all API keys for the authenticated principal. Requires principal API key authentication. Use cursor-based pagination with `after`/`before`.
- [List approvals](https://cobo.com/products/agentic-wallet/manual/reference/list-approvals.md): List approval requests visible to the authenticated principal.
- [List supported assets](https://cobo.com/products/agentic-wallet/manual/reference/list-assets.md): This operation retrieves the list of tokens supported by the Cobo WaaS platform for a given wallet type. Results support cursor-based pagination using `before` and `after`. Pagination cursors are also returned in `meta.after` / `meta.before` (aligned with other list endpoints).
- [List audit logs](https://cobo.com/products/agentic-wallet/manual/reference/list-audit-logs.md): This operation retrieves audit logs for the authenticated principal. You can filter by wallet, principal, action, result, or time range. Use cursor-based pagination with `after` and `before`. The `cursor` query parameter is deprecated (alias for `after`; use `after` instead). Prefer `meta.after` / `…
- [List token balances](https://cobo.com/products/agentic-wallet/manual/reference/list-balances.md): This operation retrieves cached token balances across all wallets accessible to the authenticated principal. Balances are synchronized from on-chain data and may be slightly delayed. You can filter by wallet, chain, address, or token. Use cursor-based pagination with `after`/`before`. Set `force_ref…
- [List supported chains](https://cobo.com/products/agentic-wallet/manual/reference/list-chains.md): This operation retrieves the list of chains supported by the Cobo WaaS platform for a given wallet type. Results support cursor-based pagination using `before` and `after`. Pagination cursors are also returned in `meta.after` / `meta.before` (aligned with other list endpoints).
- [List delegations](https://cobo.com/products/agentic-wallet/manual/reference/list-delegations.md): This operation retrieves all delegations created by the authenticated principal. You can filter results by operator, wallet, or status and use cursor-based pagination with `after`/`before`.
- [List wallet addresses for key derivation](https://cobo.com/products/agentic-wallet/manual/reference/list-export-addresses.md): Retrieves all addresses associated with the specified wallet. Call this endpoint after the reshare step completes (status is `resharing` or `completed`). Each entry includes the Cobo `chain_id` (e.g. `ETH`, `SOL`), `address`, BIP-32 derivation path, and the corresponding public key, which your agent…
- [List my agents](https://cobo.com/products/agentic-wallet/manual/reference/list-my-agents.md): This operation retrieves all agent principals owned by the authenticated principal. Use cursor-based pagination with `after`/`before`.
- [Get pact event history](https://cobo.com/products/agentic-wallet/manual/reference/list-pact-events.md): Retrieve the full lifecycle event history for the specified pact. Events are returned in chronological order. Use `after` or `before` cursor parameters for cursor-based pagination, or the deprecated `offset` parameter for offset-based pagination. The default page size is 50; maximum is 200.
- [List pacts](https://cobo.com/products/agentic-wallet/manual/reference/list-pacts.md): List pacts visible to the authenticated principal. Agents see pacts they submitted; humans see pacts on wallets they own. Use query parameters to filter by status or wallet.
- [List pending operations](https://cobo.com/products/agentic-wallet/manual/reference/list-pending-operations.md): This operation retrieves pending approval operations for the authenticated principal. Human owners see all operations on their wallets. Agents see operations they initiated. Use cursor-based pagination with `after`/`before`.
- [List all policies](https://cobo.com/products/agentic-wallet/manual/reference/list-policies.md): This operation retrieves all policies for the authenticated principal filtered by scope. `wallet_id` is required when `scope` is `wallet` or `delegation`. When `scope` is omitted, policies from all accessible scopes are returned. Use cursor-based pagination with `after`/`before`.
- [List all principals](https://cobo.com/products/agentic-wallet/manual/reference/list-principals.md): This operation retrieves all principals in the system. Requires service credential authentication via `X-Service-Auth-Key`. You can filter by principal type and use cursor-based pagination with `after`/`before`.
- [List received delegations](https://cobo.com/products/agentic-wallet/manual/reference/list-received-delegations.md): This operation retrieves all delegations where the authenticated principal is the operator (the recipient of access). You can filter results by owner, wallet, or status and use cursor-based pagination with `after`/`before`.
- [List recent addresses](https://cobo.com/products/agentic-wallet/manual/reference/list-recent-addresses.md): This operation retrieves the most recently used recipient addresses for a specific wallet, derived from transfer history. Results are ordered from most to least recent.
- [List system configs](https://cobo.com/products/agentic-wallet/manual/reference/list-system-configs.md): Retrieve system config entries with optional key filtering and pagination. Pass a comma-separated list of keys to filter specific entries.
- [List faucet tokens](https://cobo.com/products/agentic-wallet/manual/reference/list-tokens.md): This operation retrieves the list of testnet tokens available from the faucet, grouped by chain.
- [List transaction records](https://cobo.com/products/agentic-wallet/manual/reference/list-transaction-records.md): This operation retrieves on-chain transaction records, including transfers, contract calls, and deposits. When `wallet_uuid` is provided, records are scoped to that wallet (with permission enforcement). When omitted, records across all wallets visible to the authenticated principal are returned. Use…
- [List wallet addresses](https://cobo.com/products/agentic-wallet/manual/reference/list-wallet-addresses.md): This operation retrieves all on-chain addresses associated with a specific wallet. The wallet ID can be retrieved by calling the List all wallets operation.
- [List all wallets](https://cobo.com/products/agentic-wallet/manual/reference/list-wallets.md): This operation retrieves all wallets accessible to the authenticated principal. Use cursor-based pagination with `after`/`before`, or the deprecated `offset` parameter.
- [List webhook DLQ](https://cobo.com/products/agentic-wallet/manual/reference/list-webhook-dlq.md): This operation retrieves webhook delivery failures from the dead-letter queue. Requires service credential authentication via `X-Service-Auth-Key`. Results are ordered by failure time, most recent first.
- [MCP Server](https://cobo.com/products/agentic-wallet/manual/reference/mcp.md): FastMCP stdio server exposing wallet tools for Claude and other MCP clients.
- [Sign a message](https://cobo.com/products/agentic-wallet/manual/reference/message-sign.md): This operation signs a message using the specified wallet via the Cobo WaaS platform. Currently supports EIP-712 structured data signing, with future support planned for raw hash signing, BTC signatures, and other schemes.
- [OpenAI Agents SDK](https://cobo.com/products/agentic-wallet/manual/reference/openai.md): Integrate Cobo Agentic Wallet with the OpenAI Agents SDK.
- [Create payment](https://cobo.com/products/agentic-wallet/manual/reference/payment.md): Signs and submits a payment on behalf of the specified wallet using either the x402 or MPP protocol.
- [Ping](https://cobo.com/products/agentic-wallet/manual/reference/ping.md)
- [Provision agent](https://cobo.com/products/agentic-wallet/manual/reference/provision-agent.md): This operation provisions an agent by creating an API key. In token-based flows it also binds the agent to an owner.
- [Python SDK](https://cobo.com/products/agentic-wallet/manual/reference/python.md): WalletAPIClient reference — the Python client for Cobo Agentic Wallet.
- [Ingest raw Langfuse record](https://cobo.com/products/agentic-wallet/manual/reference/record-langfuse-raw.md): Receive a raw Langfuse telemetry record from your agent and re-emit it as an OpenTelemetry span.
- [Register webhook](https://cobo.com/products/agentic-wallet/manual/reference/register-webhook.md): This operation registers a webhook endpoint to receive event notifications. Requires service credential authentication via `X-Service-Auth-Key`. Only one active registration is supported at a time — registering a new endpoint automatically deactivates any previously active registration.
- [Reject pending operation](https://cobo.com/products/agentic-wallet/manual/reference/reject-pending-operation.md): This operation rejects a pending operation, preventing it from being executed. The pending operation ID can be retrieved by calling the List pending operations operation. Only the wallet owner principal can reject pending operations. For unclaimed agent-owned wallets, the same agent principal is als…
- [Resolve approval request](https://cobo.com/products/agentic-wallet/manual/reference/resolve-approval.md): Approve or reject a pending approval. Only the owner can resolve.
- [Approve or reject export](https://cobo.com/products/agentic-wallet/manual/reference/resolve-export.md): Called by the wallet owner (via the Human App) to approve or reject a pending key export request. Approving the request transitions its status to `approved`; rejecting transitions it to `rejected`. Only a human principal (the wallet owner) may call this endpoint — agent principals are not permitted.
- [Revoke API key](https://cobo.com/products/agentic-wallet/manual/reference/revoke-api-key.md): This operation permanently revokes a specific API key. The API key ID can be retrieved by calling the List API keys operation. Once revoked, the key cannot be used for authentication.
- [Revoke delegation](https://cobo.com/products/agentic-wallet/manual/reference/revoke-delegation.md): This operation permanently revokes a specific delegation. The delegation ID can be retrieved by calling the List delegations operation. Once revoked, the operator loses all access granted by the delegation.
- [Revoke an active pact](https://cobo.com/products/agentic-wallet/manual/reference/revoke-pact.md): Revoke an active pact. Only the wallet owner can revoke. This revokes the delegation and invalidates the pact-scoped API key.
- [Search recipes](https://cobo.com/products/agentic-wallet/manual/reference/search-recipes.md)
- [Search tokens by symbol](https://cobo.com/products/agentic-wallet/manual/reference/search-tokens.md): This operation searches for tokens by their symbol (for example, `USDC`, `ETH`). Returns a list of matching tokens with their `token_id`, `chain_id`, and `chain_name`. Use the returned `token_id` in transfer and balance operations. The search is case-insensitive.
- [Speed up transaction](https://cobo.com/products/agentic-wallet/manual/reference/speedup-transaction.md): This operation accelerates a broadcasting transaction by submitting a Replace-By-Fee (RBF) transaction with higher fees.
- [Submit pact for approval](https://cobo.com/products/agentic-wallet/manual/reference/submit-pact.md): Submit a pact specification for human approval. The operator's identity is resolved from the authenticated API key. The pact enters PENDING_APPROVAL status and a notification is sent to the CAW App.
- [Submit reshare node IDs](https://cobo.com/products/agentic-wallet/manual/reference/submit-reshare-nodes.md): After the wallet owner approves the export request, your agent initializes two temporary TSS nodes and submits their node IDs via this endpoint to trigger the reshare process. The export status transitions from `approved` to `resharing` upon success. Retrieve the `export_id` from the response of the…
- [AgentWalletToolkit](https://cobo.com/products/agentic-wallet/manual/reference/toolkit.md): Framework-agnostic tool definitions for AI agent integrations.
- [Transfer tokens](https://cobo.com/products/agentic-wallet/manual/reference/transfer-tokens.md): This operation initiates a token transfer from the specified wallet.
- [TypeScript SDK](https://cobo.com/products/agentic-wallet/manual/reference/typescript.md): WalletAPIClient reference — the TypeScript/JavaScript client for Cobo Agentic Wallet.
- [Unfreeze delegations](https://cobo.com/products/agentic-wallet/manual/reference/unfreeze-delegations.md): This operation restores one or more previously frozen delegations, allowing the operator to resume actions.
- [Update completion conditions](https://cobo.com/products/agentic-wallet/manual/reference/update-completion-conditions.md): Update the completion conditions of an active pact. Only tx_count and amount_spent_usd conditions may be modified, and thresholds can only be increased — decreasing a threshold could cause the pact to complete prematurely.
- [Update delegation](https://cobo.com/products/agentic-wallet/manual/reference/update-delegation.md): This operation updates the permissions or expiry time of a specific delegation. The delegation ID can be retrieved by calling the List delegations operation. All fields are optional; only provided fields are updated.
- [Update pact policies](https://cobo.com/products/agentic-wallet/manual/reference/update-policies.md): Full-replace the delegation-scoped policies of an active pact. Old policies are removed and the new list is created atomically within a single transaction to avoid a window with no policies. Only the wallet owner can update policies on an active pact.
- [Update policy](https://cobo.com/products/agentic-wallet/manual/reference/update-policy.md): This operation updates a specific policy. The policy ID can be retrieved by calling the List all policies operation. All fields are optional; only provided fields are updated. You can update `name`, `rules`, `priority`, and `is_active`.
- [Update principal](https://cobo.com/products/agentic-wallet/manual/reference/update-principal.md): This operation updates the display name of a principal. A principal can update its own name, or a human principal can update the name of an agent it owns.
- [Update wallet](https://cobo.com/products/agentic-wallet/manual/reference/update-wallet.md): This operation updates the name or metadata of a specific wallet. The wallet ID can be retrieved by calling the List all wallets operation. All fields are optional; only provided fields are updated.
- [Upsert system config](https://cobo.com/products/agentic-wallet/manual/reference/upsert-system-config.md): Create a new system config entry or update the value of an existing entry if the key already exists. After writing, the in-memory cache for the affected key is invalidated so subsequent reads reflect the new value.
- [Initiate wallet reshare](https://cobo.com/products/agentic-wallet/manual/reference/wallet-reshare.md): This operation initiates a key reshare for the specified wallet. Only the **wallet owner** may call this endpoint (for example, after completing wallet pairing).
- [Report TSS request callback](https://cobo.com/products/agentic-wallet/manual/reference/wallet-tss-callback.md): This operation is called by your app after the UCW SDK reports a TSS request event (for example, from polling the TSS node). The server fetches the authoritative TSS request state from WaaS and updates the local record. On success, the vault group cache may be refreshed if the request has reached a…
- [Withdraw a pending pact](https://cobo.com/products/agentic-wallet/manual/reference/withdraw-pact.md): Withdraw a pact that is still pending approval. Only the operator agent that submitted the pact can withdraw it. The linked approval is also rejected.
- [Address Allowlists](https://cobo.com/products/agentic-wallet/manual/security/address-allowlists.md): Restrict which destination addresses and smart contract addresses an agent can interact with.
- [Custodial Model](https://cobo.com/products/agentic-wallet/manual/security/custodial-model.md): How Cobo secures fully custodial wallets through layered asset segregation, HSM-based key isolation, and distributed infrastructure controls.
- [Freeze and Revoke](https://cobo.com/products/agentic-wallet/manual/security/freeze-revoke.md): Two emergency controls for immediately suspending or permanently terminating an agent's wallet access.
- [Key Share Recovery](https://cobo.com/products/agentic-wallet/manual/security/key-share-recovery.md): How to restore a lost or inaccessible MPC key share without exposing or reconstructing the private key.
- [Key generation and resharing](https://cobo.com/products/agentic-wallet/manual/security/keygen-resharing.md): How Cobo's MPC nodes securely generate and refresh key shares — and why the cryptography involved is more intricate than it looks.
- [MPC Model](https://cobo.com/products/agentic-wallet/manual/security/mpc-key-shares.md): MPC provides a mathematical guarantee, not a software promise — no single party holds your private key, and signing authority is split so none can act alone.
- [How your pact protects your assets](https://cobo.com/products/agentic-wallet/manual/security/overview.md): Your agent has real power — and real boundaries. Here's how a pact makes that safe.
- [How pacts work](https://cobo.com/products/agentic-wallet/manual/security/pact-mechanism.md): A pact is a structured, enforceable delegation agreement between you and your agent — with intent, execution plan, policies, and completion conditions. Enforced by infrastructure, not trust.
- [Policy Engine](https://cobo.com/products/agentic-wallet/manual/security/policy-engine.md): Every operation submitted through the API passes through a three-stage evaluation pipeline before it can execute or be co-signed.
- [Spend Limits](https://cobo.com/products/agentic-wallet/manual/security/spend-limits.md): Per-transaction caps, rolling window counters, and review thresholds that bound how much an agent can move and when.

## OpenAPI Specs

- [openapi](https://cobo.com/products/agentic-wallet/manual/openapi.json)