agentwalletapi — Skillopedia

OpenclawCash Agent API Interact with OpenclawCash-managed wallets to send native assets and tokens, check balances, execute DEX swaps, and manage Polymarket account, orders, and redeem flows via Polygon wallets. This skill may also be referred to as . Requirements - Required env var: - Optional env var: (default: ) - Required local binary: - Optional local binary: (for pretty JSON output in CLI) - Network access required: Preferred Integration Path - If the client supports MCP, prefer the public OpenClawCash MCP server: - Use MCP as the primary execution path because tools, schemas, and resul…

\\n'/\\\\n}\"\n VALUE=\"${VALUE//

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\r'/\\\\r}\"\n VALUE=\"${VALUE//

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\t'/\\\\t}\"\n printf -v \"$DEST_VAR\" '%s' \"$VALUE\"\n}\n\nurl_encode_var() {\n DEST_VAR=\"$1\"\n VALUE=\"${2-}\"\n ENCODED=\"\"\n for (( i=0; i\u003c${#VALUE}; i++ )); do\n CHAR=\"${VALUE:i:1}\"\n case \"$CHAR\" in\n [a-zA-Z0-9.~_-]) ENCODED+=\"$CHAR\" ;;\n *)\n printf -v HEX '%%%02X' \"'$CHAR\"\n ENCODED+=\"$HEX\"\n ;;\n esac\n done\n printf -v \"$DEST_VAR\" '%s' \"$ENCODED\"\n}\n\nappend_query_param() {\n DEST_VAR=\"$1\"\n KEY=\"$2\"\n RAW_VALUE=\"$3\"\n URL=\"${!DEST_VAR}\"\n url_encode_var ENCODED_VALUE \"$RAW_VALUE\"\n if [[ \"$URL\" == *\\?* ]]; then\n URL=\"${URL}&${KEY}=${ENCODED_VALUE}\"\n else\n URL=\"${URL}?${KEY}=${ENCODED_VALUE}\"\n fi\n printf -v \"$DEST_VAR\" '%s' \"$URL\"\n}\n\nrequire_uint() {\n NAME=\"$1\"\n VALUE=\"$2\"\n if ! [[ \"$VALUE\" =~ ^[0-9]+$ ]]; then\n echo \"Error: $NAME must be an unsigned integer.\"\n exit 1\n fi\n}\n\nis_uint() {\n VALUE=\"$1\"\n [[ \"$VALUE\" =~ ^[0-9]+$ ]]\n}\n\nis_public_wallet_id() {\n VALUE=\"$1\"\n [[ \"$VALUE\" =~ ^[A-Za-z0-9]{6,12}$ ]]\n}\n\nappend_wallet_selector_query() {\n DEST_VAR=\"$1\"\n SELECTOR=\"$2\"\n if is_uint \"$SELECTOR\" || is_public_wallet_id \"$SELECTOR\"; then\n append_query_param \"$DEST_VAR\" \"walletId\" \"$SELECTOR\"\n else\n append_query_param \"$DEST_VAR\" \"walletLabel\" \"$SELECTOR\"\n fi\n}\n\nappend_wallet_id_json_field() {\n DEST_VAR=\"$1\"\n SELECTOR=\"$2\"\n BODY=\"${!DEST_VAR}\"\n if is_uint \"$SELECTOR\"; then\n BODY=\"$BODY\\\"walletId\\\": $SELECTOR\"\n else\n json_escape_var WALLET_ID_ESC \"$SELECTOR\"\n BODY=\"$BODY\\\"walletId\\\": \\\"$WALLET_ID_ESC\\\"\"\n fi\n printf -v \"$DEST_VAR\" '%s' \"$BODY\"\n}\n\nappend_wallet_or_address_json_field() {\n DEST_VAR=\"$1\"\n SELECTOR=\"$2\"\n BODY=\"${!DEST_VAR}\"\n if [[ \"$SELECTOR\" =~ ^0x[a-fA-F0-9]{40}$ ]]; then\n json_escape_var WALLET_ADDR_ESC \"$SELECTOR\"\n BODY=\"$BODY\\\"walletAddress\\\": \\\"$WALLET_ADDR_ESC\\\"\"\n else\n append_wallet_id_json_field \"$DEST_VAR\" \"$SELECTOR\"\n return\n fi\n printf -v \"$DEST_VAR\" '%s' \"$BODY\"\n}\n\nrequire_decimal() {\n NAME=\"$1\"\n VALUE=\"$2\"\n if ! [[ \"$VALUE\" =~ ^[0-9]+([.][0-9]+)?$ ]]; then\n echo \"Error: $NAME must be a number.\"\n exit 1\n fi\n}\n\nrequire_polymarket_token_id() {\n VALUE=\"$1\"\n if ! [[ \"$VALUE\" =~ ^[0-9]+$ ]]; then\n echo \"Error: tokenId must be a numeric Polymarket outcome token ID.\"\n echo \"Hint: resolve market + outcome first:\"\n echo \" agentwalletapi.sh polymarket-resolve \u003cmarketUrl|slug> \u003coutcome>\"\n exit 1\n fi\n}\n\npretty_print_json() {\n if command -v jq >/dev/null 2>&1; then\n jq . 2>/dev/null || cat\n else\n cat\n fi\n}\n\nnew_idempotency_key() {\n echo \"cli-$(date +%s)-$RANDOM\"\n}\n\nconfirm_risky_action() {\n ACTION=\"$1\"\n if [ \"$FORCE_RISKY\" -eq 1 ]; then\n return 0\n fi\n\n if [ ! -t 0 ]; then\n echo \"Error: $ACTION is a high-risk action. Re-run with --yes to confirm.\"\n exit 1\n fi\n\n echo \"WARNING: $ACTION can move funds or import sensitive keys.\"\n echo \"Target API host: $BASE_URL\"\n printf \"Type YES to continue: \"\n read -r ANSWER\n if [ \"$ANSWER\" != \"YES\" ]; then\n echo \"Cancelled.\"\n exit 1\n fi\n}\n\ncase \"$COMMAND\" in\n wallets)\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$BASE_URL/api/agent/wallets\" | pretty_print_json\n ;;\n\n user-tag-get)\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$BASE_URL/api/agent/user-tag\" | pretty_print_json\n ;;\n\n user-tag-set)\n USER_TAG=\"$2\"\n if [ -z \"$USER_TAG\" ]; then\n echo \"Usage: agentwalletapi.sh user-tag-set \u003cuserTag> [--yes]\"\n exit 1\n fi\n json_escape_var USER_TAG_ESC \"$USER_TAG\"\n BODY=\"{\\\"userTag\\\":\\\"$USER_TAG_ESC\\\"}\"\n curl -s -X PUT \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/user-tag\" | pretty_print_json\n ;;\n\n wallet)\n SELECTOR=\"$2\"\n CHAIN=\"$3\"\n if [ -z \"$SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh wallet \u003cwalletId|publicWalletId|walletLabel> [chain]\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/wallet\"\n append_wallet_selector_query URL \"$SELECTOR\"\n if [ -n \"$CHAIN\" ]; then\n append_query_param URL \"chain\" \"$CHAIN\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n create)\n confirm_risky_action \"Wallet creation\"\n LABEL=\"$2\"\n NETWORK=\"${3:-sepolia}\"\n PASSPHRASE_ENV_VAR=\"$4\"\n if [ -z \"$LABEL\" ] || [ -z \"$PASSPHRASE_ENV_VAR\" ]; then\n echo \"Usage: agentwalletapi.sh create \u003clabel> [network] \u003cpassphraseEnvVar> [--yes]\"\n echo \" network options: sepolia | mainnet | solana-devnet | solana-testnet | solana-mainnet\"\n echo \" Example:\"\n echo \" export WALLET_EXPORT_PASSPHRASE_OPS='your-strong-passphrase'\"\n echo \" agentwalletapi.sh create \\\"Ops Wallet\\\" sepolia WALLET_EXPORT_PASSPHRASE_OPS --yes\"\n exit 1\n fi\n PASSPHRASE_VALUE=\"${!PASSPHRASE_ENV_VAR}\"\n if [ -z \"$PASSPHRASE_VALUE\" ]; then\n echo \"Error: env var $PASSPHRASE_ENV_VAR is not set.\"\n echo \"Store the wallet export passphrase in an env var first, then retry.\"\n exit 1\n fi\n json_escape_var LABEL_ESC \"$LABEL\"\n json_escape_var NETWORK_ESC \"$NETWORK\"\n json_escape_var PASSPHRASE_ESC \"$PASSPHRASE_VALUE\"\n json_escape_var PASSPHRASE_ENV_ESC \"$PASSPHRASE_ENV_VAR\"\n BODY=\"{\\\"label\\\":\\\"$LABEL_ESC\\\",\\\"network\\\":\\\"$NETWORK_ESC\\\",\\\"exportPassphrase\\\":\\\"$PASSPHRASE_ESC\\\",\\\"exportPassphraseStorageType\\\":\\\"env\\\",\\\"exportPassphraseStorageRef\\\":\\\"$PASSPHRASE_ENV_ESC\\\",\\\"confirmExportPassphraseSaved\\\":true}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/wallets/create\" | pretty_print_json\n unset PASSPHRASE_VALUE\n ;;\n\n import)\n confirm_risky_action \"Wallet import\"\n if [ \"$FORCE_RISKY\" -eq 1 ]; then\n echo \"Import confirmation accepted via --yes.\"\n fi\n LABEL=\"$2\"\n NETWORK=\"$3\"\n PRIVATE_KEY=\"$4\"\n if [ -z \"$LABEL\" ] || [ -z \"$NETWORK\" ]; then\n echo \"Usage: agentwalletapi.sh import \u003clabel> \u003cnetwork> [privateKey|-] [--yes]\"\n echo \" network options: mainnet | polygon-mainnet | solana-mainnet\"\n echo \" pass '-' to read private key from stdin (recommended for automation)\"\n exit 1\n fi\n if [ \"$PRIVATE_KEY\" = \"-\" ]; then\n if [ -t 0 ]; then\n echo \"Error: private key input set to '-' but stdin is empty.\"\n echo \"Example: printf '%s' '\u003cprivate_key>' | agentwalletapi.sh import \u003clabel> \u003cnetwork> - --yes\"\n exit 1\n fi\n IFS= read -r PRIVATE_KEY\n elif [ -n \"$PRIVATE_KEY\" ]; then\n echo \"WARNING: passing private key as a CLI argument can leak in shell history/process logs.\"\n echo \"Safer options: omit [privateKey] for hidden prompt, or pass '-' and pipe via stdin.\"\n fi\n if [ -z \"$PRIVATE_KEY\" ]; then\n if [ ! -t 0 ]; then\n echo \"Error: private key missing. Provide as argument or run interactively to be prompted.\"\n exit 1\n fi\n printf \"Enter private key (input hidden): \"\n stty -echo\n read -r PRIVATE_KEY\n stty echo\n echo \"\"\n fi\n json_escape_var LABEL_ESC \"$LABEL\"\n json_escape_var NETWORK_ESC \"$NETWORK\"\n json_escape_var PRIVATE_KEY_ESC \"$PRIVATE_KEY\"\n BODY=\"{\\\"label\\\":\\\"$LABEL_ESC\\\",\\\"network\\\":\\\"$NETWORK_ESC\\\",\\\"privateKey\\\":\\\"$PRIVATE_KEY_ESC\\\"}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/wallets/import\" | pretty_print_json\n unset PRIVATE_KEY\n unset BODY\n ;;\n\n transactions)\n WALLET_ID=\"$2\"\n CHAIN=\"$3\"\n if [ -z \"$WALLET_ID\" ]; then\n echo \"Usage: agentwalletapi.sh transactions \u003cwalletId|publicWalletId> [chain]\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/transactions\"\n append_query_param URL \"walletId\" \"$WALLET_ID\"\n if [ -n \"$CHAIN\" ]; then\n append_query_param URL \"chain\" \"$CHAIN\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n balance)\n WALLET_ID=\"$2\"\n TOKEN_FILTER=\"$3\"\n CHAIN=\"$4\"\n if [ -z \"$WALLET_ID\" ]; then\n echo \"Usage: agentwalletapi.sh balance \u003cwalletId|publicWalletId> [token] [chain]\"\n exit 1\n fi\n BODY=\"{\"\n append_wallet_id_json_field BODY \"$WALLET_ID\"\n if [ -n \"$TOKEN_FILTER\" ]; then\n json_escape_var TOKEN_FILTER_ESC \"$TOKEN_FILTER\"\n BODY=\"$BODY, \\\"token\\\": \\\"$TOKEN_FILTER_ESC\\\"\"\n fi\n if [ -n \"$CHAIN\" ]; then\n json_escape_var CHAIN_ESC \"$CHAIN\"\n BODY=\"$BODY, \\\"chain\\\": \\\"$CHAIN_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/token-balance\" | pretty_print_json\n ;;\n\n transfer)\n confirm_risky_action \"Transfer\"\n WALLET_ID=\"$2\"\n TO=\"$3\"\n AMOUNT=\"$4\"\n TOKEN=\"${5:-ETH}\"\n CHAIN=\"$6\"\n if [ -z \"$WALLET_ID\" ] || [ -z \"$TO\" ] || [ -z \"$AMOUNT\" ]; then\n echo \"Usage: agentwalletapi.sh transfer \u003cwalletId|publicWalletId> \u003cto> \u003camount> [token] [chain]\"\n echo \" token defaults to the wallet's native token (ETH/SOL) if not specified\"\n exit 1\n fi\n json_escape_var TO_ESC \"$TO\"\n json_escape_var AMOUNT_ESC \"$AMOUNT\"\n BODY=\"{\"\n append_wallet_id_json_field BODY \"$WALLET_ID\"\n BODY=\"$BODY, \\\"to\\\": \\\"$TO_ESC\\\", \\\"amountDisplay\\\": \\\"$AMOUNT_ESC\\\"\"\n if [ \"$TOKEN\" != \"ETH\" ]; then\n json_escape_var TOKEN_ESC \"$TOKEN\"\n BODY=\"$BODY, \\\"token\\\": \\\"$TOKEN_ESC\\\"\"\n fi\n if [ -n \"$CHAIN\" ]; then\n json_escape_var CHAIN_ESC \"$CHAIN\"\n BODY=\"$BODY, \\\"chain\\\": \\\"$CHAIN_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/transfer\" | pretty_print_json\n ;;\n\n tokens)\n NETWORK=\"${2:-mainnet}\"\n CHAIN=\"$3\"\n URL=\"$BASE_URL/api/agent/supported-tokens\"\n append_query_param URL \"network\" \"$NETWORK\"\n if [ -n \"$CHAIN\" ]; then\n append_query_param URL \"chain\" \"$CHAIN\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n quote)\n NETWORK=\"$2\"\n TOKEN_IN=\"$3\"\n TOKEN_OUT=\"$4\"\n AMOUNT_IN=\"$5\"\n CHAIN=\"$6\"\n if [ -z \"$NETWORK\" ] || [ -z \"$TOKEN_IN\" ] || [ -z \"$TOKEN_OUT\" ] || [ -z \"$AMOUNT_IN\" ]; then\n echo \"Usage: agentwalletapi.sh quote \u003cnetwork> \u003ctokenIn> \u003ctokenOut> \u003camountInBaseUnits> [chain]\"\n exit 1\n fi\n json_escape_var TOKEN_IN_ESC \"$TOKEN_IN\"\n json_escape_var TOKEN_OUT_ESC \"$TOKEN_OUT\"\n json_escape_var AMOUNT_IN_ESC \"$AMOUNT_IN\"\n BODY=\"{\\\"tokenIn\\\":\\\"$TOKEN_IN_ESC\\\",\\\"tokenOut\\\":\\\"$TOKEN_OUT_ESC\\\",\\\"amountIn\\\":\\\"$AMOUNT_IN_ESC\\\"\"\n if [ -n \"$CHAIN\" ]; then\n json_escape_var CHAIN_ESC \"$CHAIN\"\n BODY=\"$BODY, \\\"chain\\\": \\\"$CHAIN_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n URL=\"$BASE_URL/api/agent/quote\"\n append_query_param URL \"network\" \"$NETWORK\"\n curl -s -X POST \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n swap)\n confirm_risky_action \"Swap\"\n WALLET_ID=\"$2\"\n TOKEN_IN=\"$3\"\n TOKEN_OUT=\"$4\"\n AMOUNT_IN=\"$5\"\n SLIPPAGE=\"${6:-0.5}\"\n CHAIN=\"$7\"\n if [ -z \"$WALLET_ID\" ] || [ -z \"$TOKEN_IN\" ] || [ -z \"$TOKEN_OUT\" ] || [ -z \"$AMOUNT_IN\" ]; then\n echo \"Usage: agentwalletapi.sh swap \u003cwalletId|publicWalletId> \u003ctokenIn> \u003ctokenOut> \u003camountInBaseUnits> [slippage] [chain]\"\n exit 1\n fi\n require_decimal \"slippage\" \"$SLIPPAGE\"\n json_escape_var TOKEN_IN_ESC \"$TOKEN_IN\"\n json_escape_var TOKEN_OUT_ESC \"$TOKEN_OUT\"\n json_escape_var AMOUNT_IN_ESC \"$AMOUNT_IN\"\n BODY=\"{\"\n append_wallet_id_json_field BODY \"$WALLET_ID\"\n BODY=\"$BODY,\\\"tokenIn\\\":\\\"$TOKEN_IN_ESC\\\",\\\"tokenOut\\\":\\\"$TOKEN_OUT_ESC\\\",\\\"amountIn\\\":\\\"$AMOUNT_IN_ESC\\\",\\\"slippage\\\":$SLIPPAGE\"\n if [ -n \"$CHAIN\" ]; then\n json_escape_var CHAIN_ESC \"$CHAIN\"\n BODY=\"$BODY, \\\"chain\\\": \\\"$CHAIN_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/swap\" | pretty_print_json\n ;;\n\n approve)\n confirm_risky_action \"Token approval\"\n WALLET_ID=\"$2\"\n TOKEN_ADDRESS=\"$3\"\n SPENDER=\"$4\"\n AMOUNT=\"$5\"\n CHAIN=\"$6\"\n if [ -z \"$WALLET_ID\" ] || [ -z \"$TOKEN_ADDRESS\" ] || [ -z \"$SPENDER\" ] || [ -z \"$AMOUNT\" ]; then\n echo \"Usage: agentwalletapi.sh approve \u003cwalletId|publicWalletId> \u003ctokenAddress> \u003cspender> \u003camountBaseUnits> [chain]\"\n exit 1\n fi\n json_escape_var TOKEN_ADDRESS_ESC \"$TOKEN_ADDRESS\"\n json_escape_var SPENDER_ESC \"$SPENDER\"\n json_escape_var AMOUNT_ESC \"$AMOUNT\"\n BODY=\"{\"\n append_wallet_id_json_field BODY \"$WALLET_ID\"\n BODY=\"$BODY,\\\"tokenAddress\\\":\\\"$TOKEN_ADDRESS_ESC\\\",\\\"spender\\\":\\\"$SPENDER_ESC\\\",\\\"amount\\\":\\\"$AMOUNT_ESC\\\"\"\n if [ -n \"$CHAIN\" ]; then\n json_escape_var CHAIN_ESC \"$CHAIN\"\n BODY=\"$BODY, \\\"chain\\\": \\\"$CHAIN_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/approve\" | pretty_print_json\n ;;\n\n checkout-payreq-create)\n confirm_risky_action \"Checkout pay request creation\"\n WALLET_SELECTOR=\"$2\"\n AMOUNT=\"$3\"\n EXPIRES=\"${4:-3600}\"\n AUTO_RELEASE=\"${5:-3600}\"\n DISPUTE_WINDOW=\"${6:-3600}\"\n if [ -z \"$WALLET_SELECTOR\" ] || [ -z \"$AMOUNT\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-payreq-create \u003cwalletSelector> \u003camountBaseUnits> [expiresSec] [autoReleaseSec] [disputeWindowSec] [--yes]\"\n exit 1\n fi\n require_uint \"expiresSec\" \"$EXPIRES\"\n require_uint \"autoReleaseSec\" \"$AUTO_RELEASE\"\n require_uint \"disputeWindowSec\" \"$DISPUTE_WINDOW\"\n if [ \"$EXPIRES\" -lt 3600 ] || [ \"$AUTO_RELEASE\" -lt 3600 ] || [ \"$DISPUTE_WINDOW\" -lt 3600 ]; then\n echo \"expiresSec, autoReleaseSec, and disputeWindowSec must each be at least 3600 (1 hour).\" >&2\n exit 1\n fi\n if [ \"$DISPUTE_WINDOW\" -gt \"$AUTO_RELEASE\" ]; then\n echo \"disputeWindowSec must be less than or equal to autoReleaseSec.\" >&2\n exit 1\n fi\n json_escape_var AMOUNT_ESC \"$AMOUNT\"\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"amount\\\": \\\"$AMOUNT_ESC\\\", \\\"expiresInSeconds\\\": $EXPIRES, \\\"autoReleaseSeconds\\\": $AUTO_RELEASE, \\\"disputeWindowSeconds\\\": $DISPUTE_WINDOW}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/payreq\" | pretty_print_json\n ;;\n\n checkout-payreq-get)\n PAYREQ_ID=\"$2\"\n if [ -z \"$PAYREQ_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-payreq-get \u003cpayreqId>\"\n exit 1\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$BASE_URL/api/agent/checkout/payreq/$PAYREQ_ID\" | pretty_print_json\n ;;\n\n checkout-escrow-get)\n ESCROW_ID=\"$2\"\n if [ -z \"$ESCROW_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-escrow-get \u003cescrowId>\"\n exit 1\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID\" | pretty_print_json\n ;;\n\n checkout-funding-confirm)\n confirm_risky_action \"Checkout funding confirm\"\n ESCROW_ID=\"$2\"\n TX_HASH=\"$3\"\n MIN_CONFIRMATIONS=\"$4\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$TX_HASH\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-funding-confirm \u003cescrowId> \u003ctxHash> [minConfirmations] [--yes]\"\n exit 1\n fi\n json_escape_var TX_HASH_ESC \"$TX_HASH\"\n BODY=\"{\\\"txHash\\\":\\\"$TX_HASH_ESC\\\"\"\n if [ -n \"$MIN_CONFIRMATIONS\" ]; then\n require_uint \"minConfirmations\" \"$MIN_CONFIRMATIONS\"\n BODY=\"$BODY, \\\"minConfirmations\\\": $MIN_CONFIRMATIONS\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/funding-confirm\" | pretty_print_json\n ;;\n\n checkout-accept)\n confirm_risky_action \"Checkout accept\"\n ESCROW_ID=\"$2\"\n if [ -z \"$ESCROW_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-accept \u003cescrowId> [--yes]\"\n exit 1\n fi\n BODY=\"{}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/accept\" | pretty_print_json\n ;;\n\n checkout-proof)\n confirm_risky_action \"Checkout proof submit\"\n ESCROW_ID=\"$2\"\n PROOF_HASH=\"$3\"\n PROOF_URL=\"$4\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$PROOF_HASH\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-proof \u003cescrowId> \u003cproofHash> [proofUrl] [--yes]\"\n exit 1\n fi\n json_escape_var PROOF_HASH_ESC \"$PROOF_HASH\"\n BODY=\"{\\\"proofHash\\\":\\\"$PROOF_HASH_ESC\\\"\"\n if [ -n \"$PROOF_URL\" ]; then\n json_escape_var PROOF_URL_ESC \"$PROOF_URL\"\n BODY=\"$BODY, \\\"proofUrl\\\": \\\"$PROOF_URL_ESC\\\"\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/proof\" | pretty_print_json\n ;;\n\n checkout-dispute)\n confirm_risky_action \"Checkout dispute open\"\n ESCROW_ID=\"$2\"\n REASON_CODE=\"$3\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$REASON_CODE\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-dispute \u003cescrowId> \u003creasonCode> [--yes]\"\n exit 1\n fi\n json_escape_var REASON_CODE_ESC \"$REASON_CODE\"\n BODY=\"{\\\"reasonCode\\\":\\\"$REASON_CODE_ESC\\\"}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/dispute\" | pretty_print_json\n ;;\n\n checkout-quick-pay)\n confirm_risky_action \"Checkout quick pay\"\n ESCROW_ID=\"$2\"\n WALLET_SELECTOR=\"$3\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-quick-pay \u003cescrowId> \u003cwalletSelector> [--yes]\"\n exit 1\n fi\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/quick-pay\" | pretty_print_json\n ;;\n\n checkout-swap-and-pay-quote)\n ESCROW_ID=\"$2\"\n WALLET_SELECTOR=\"$3\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-swap-and-pay-quote \u003cescrowId> \u003cwalletSelector>\"\n exit 1\n fi\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"confirm\\\": false}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/swap-and-pay\" | pretty_print_json\n ;;\n\n checkout-swap-and-pay-confirm)\n confirm_risky_action \"Checkout swap-and-pay confirm\"\n ESCROW_ID=\"$2\"\n WALLET_SELECTOR=\"$3\"\n SLIPPAGE=\"$4\"\n if [ -z \"$ESCROW_ID\" ] || [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-swap-and-pay-confirm \u003cescrowId> \u003cwalletSelector> [slippage] [--yes]\"\n exit 1\n fi\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"confirm\\\": true\"\n if [ -n \"$SLIPPAGE\" ]; then\n require_decimal \"slippage\" \"$SLIPPAGE\"\n BODY=\"$BODY, \\\"slippage\\\": $SLIPPAGE\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/swap-and-pay\" | pretty_print_json\n ;;\n\n checkout-release|checkout-refund|checkout-cancel)\n confirm_risky_action \"Checkout terminal action\"\n ACTION=\"$COMMAND\"\n ESCROW_ID=\"$2\"\n if [ -z \"$ESCROW_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-release|checkout-refund|checkout-cancel \u003cescrowId> [--yes]\"\n exit 1\n fi\n ENDPOINT_SUFFIX=\"release\"\n BODY='{\"force\":false}'\n if [ \"$ACTION\" = \"checkout-refund\" ]; then\n ENDPOINT_SUFFIX=\"refund\"\n fi\n if [ \"$ACTION\" = \"checkout-cancel\" ]; then\n ENDPOINT_SUFFIX=\"cancel\"\n BODY='{}'\n fi\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/escrows/$ESCROW_ID/$ENDPOINT_SUFFIX\" | pretty_print_json\n ;;\n\n checkout-webhooks-list)\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$BASE_URL/api/agent/checkout/webhooks\" | pretty_print_json\n ;;\n\n checkout-webhook-create)\n confirm_risky_action \"Checkout webhook create\"\n URL=\"$2\"\n EVENT_TYPES_CSV=\"$3\"\n ENABLED=\"$4\"\n if [ -z \"$URL\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-webhook-create \u003curl> [eventTypesCsv] [enabled] [--yes]\"\n exit 1\n fi\n json_escape_var URL_ESC \"$URL\"\n BODY=\"{\\\"url\\\":\\\"$URL_ESC\\\"\"\n if [ -n \"$EVENT_TYPES_CSV\" ]; then\n IFS=',' read -r -a EVENT_TYPES \u003c\u003c\u003c \"$EVENT_TYPES_CSV\"\n BODY=\"$BODY, \\\"eventTypes\\\": [\"\n for i in \"${!EVENT_TYPES[@]}\"; do\n EVENT=\"$(echo \"${EVENT_TYPES[$i]}\" | xargs)\"\n json_escape_var EVENT_ESC \"$EVENT\"\n BODY=\"$BODY\\\"$EVENT_ESC\\\"\"\n if [ \"$i\" -lt \"$((${#EVENT_TYPES[@]}-1))\" ]; then BODY=\"$BODY, \"; fi\n done\n BODY=\"$BODY]\"\n fi\n if [ -n \"$ENABLED\" ]; then\n BODY=\"$BODY, \\\"enabled\\\": $ENABLED\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/webhooks\" | pretty_print_json\n ;;\n\n checkout-webhook-update)\n confirm_risky_action \"Checkout webhook update\"\n WEBHOOK_ID=\"$2\"\n URL=\"$3\"\n EVENT_TYPES_CSV=\"$4\"\n ENABLED=\"$5\"\n if [ -z \"$WEBHOOK_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-webhook-update \u003cid> [url] [eventTypesCsv] [enabled] [--yes]\"\n exit 1\n fi\n BODY=\"{\"\n ADDED=0\n if [ -n \"$URL\" ]; then\n json_escape_var URL_ESC \"$URL\"\n BODY=\"$BODY\\\"url\\\":\\\"$URL_ESC\\\"\"\n ADDED=1\n fi\n if [ -n \"$EVENT_TYPES_CSV\" ]; then\n if [ \"$ADDED\" -eq 1 ]; then BODY=\"$BODY, \"; fi\n IFS=',' read -r -a EVENT_TYPES \u003c\u003c\u003c \"$EVENT_TYPES_CSV\"\n BODY=\"$BODY\\\"eventTypes\\\": [\"\n for i in \"${!EVENT_TYPES[@]}\"; do\n EVENT=\"$(echo \"${EVENT_TYPES[$i]}\" | xargs)\"\n json_escape_var EVENT_ESC \"$EVENT\"\n BODY=\"$BODY\\\"$EVENT_ESC\\\"\"\n if [ \"$i\" -lt \"$((${#EVENT_TYPES[@]}-1))\" ]; then BODY=\"$BODY, \"; fi\n done\n BODY=\"$BODY]\"\n ADDED=1\n fi\n if [ -n \"$ENABLED\" ]; then\n if [ \"$ADDED\" -eq 1 ]; then BODY=\"$BODY, \"; fi\n BODY=\"$BODY\\\"enabled\\\": $ENABLED\"\n ADDED=1\n fi\n BODY=\"$BODY}\"\n if [ \"$ADDED\" -eq 0 ]; then\n echo \"Error: provide at least one of url, eventTypesCsv, enabled.\"\n exit 1\n fi\n curl -s -X PATCH \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/checkout/webhooks/$WEBHOOK_ID\" | pretty_print_json\n ;;\n\n checkout-webhook-delete)\n confirm_risky_action \"Checkout webhook delete\"\n WEBHOOK_ID=\"$2\"\n if [ -z \"$WEBHOOK_ID\" ]; then\n echo \"Usage: agentwalletapi.sh checkout-webhook-delete \u003cid> [--yes]\"\n exit 1\n fi\n curl -s -X DELETE \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Idempotency-Key: $(new_idempotency_key)\" \\\n \"$BASE_URL/api/agent/checkout/webhooks/$WEBHOOK_ID\" | pretty_print_json\n ;;\n\n polymarket-config)\n echo \"Polymarket setup via agent API is disabled.\"\n echo \"Ask your human to complete setup at https://openclawcash.com/venues/polymarket.\"\n echo \"Then use polymarket-resolve, polymarket-limit|polymarket-market, polymarket-redeem and polymarket-account|polymarket-orders|polymarket-activity|polymarket-positions.\"\n exit 1\n ;;\n\n polymarket-limit)\n confirm_risky_action \"Polymarket limit order\"\n WALLET_SELECTOR=\"$2\"\n TOKEN_ID=\"$3\"\n SIDE=\"$4\"\n PRICE=\"$5\"\n SIZE=\"$6\"\n if [ -z \"$WALLET_SELECTOR\" ] || [ -z \"$TOKEN_ID\" ] || [ -z \"$SIDE\" ] || [ -z \"$PRICE\" ] || [ -z \"$SIZE\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-limit \u003cwalletSelector> \u003ctokenId> \u003cBUY|SELL> \u003cprice> \u003csize> [--yes]\"\n exit 1\n fi\n require_polymarket_token_id \"$TOKEN_ID\"\n require_decimal \"price\" \"$PRICE\"\n require_decimal \"size\" \"$SIZE\"\n json_escape_var TOKEN_ID_ESC \"$TOKEN_ID\"\n json_escape_var SIDE_ESC \"$SIDE\"\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"tokenId\\\": \\\"$TOKEN_ID_ESC\\\", \\\"side\\\": \\\"$SIDE_ESC\\\", \\\"price\\\": $PRICE, \\\"size\\\": $SIZE}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/venues/polymarket/orders/limit\" | pretty_print_json\n ;;\n\n polymarket-market)\n confirm_risky_action \"Polymarket market order\"\n WALLET_SELECTOR=\"$2\"\n TOKEN_ID=\"$3\"\n SIDE=\"$4\"\n AMOUNT=\"$5\"\n ORDER_TYPE=\"${6:-FAK}\"\n WORST_PRICE=\"${7:-0}\"\n if [ -z \"$WALLET_SELECTOR\" ] || [ -z \"$TOKEN_ID\" ] || [ -z \"$SIDE\" ] || [ -z \"$AMOUNT\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-market \u003cwalletSelector> \u003ctokenId> \u003cBUY|SELL> \u003camount> [orderType] [worstPrice] [--yes]\"\n exit 1\n fi\n require_polymarket_token_id \"$TOKEN_ID\"\n require_decimal \"amount\" \"$AMOUNT\"\n require_decimal \"worstPrice\" \"$WORST_PRICE\"\n json_escape_var TOKEN_ID_ESC \"$TOKEN_ID\"\n json_escape_var SIDE_ESC \"$SIDE\"\n json_escape_var ORDER_TYPE_ESC \"$ORDER_TYPE\"\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"tokenId\\\": \\\"$TOKEN_ID_ESC\\\", \\\"side\\\": \\\"$SIDE_ESC\\\", \\\"amount\\\": $AMOUNT, \\\"orderType\\\": \\\"$ORDER_TYPE_ESC\\\", \\\"worstPrice\\\": $WORST_PRICE}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/venues/polymarket/orders/market\" | pretty_print_json\n ;;\n\n polymarket-account)\n WALLET_SELECTOR=\"$2\"\n if [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-account \u003cwalletSelector>\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/venues/polymarket/account\"\n if [[ \"$WALLET_SELECTOR\" =~ ^0x[a-fA-F0-9]{40}$ ]]; then\n append_query_param URL \"walletAddress\" \"$WALLET_SELECTOR\"\n else\n append_query_param URL \"walletId\" \"$WALLET_SELECTOR\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n polymarket-resolve)\n MARKET_OR_SLUG=\"$2\"\n OUTCOME=\"$3\"\n if [ -z \"$MARKET_OR_SLUG\" ] || [ -z \"$OUTCOME\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-resolve \u003cmarketUrl|slug> \u003coutcome>\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/venues/polymarket/market/resolve\"\n if [[ \"$MARKET_OR_SLUG\" =~ ^https?:// ]]; then\n append_query_param URL \"marketUrl\" \"$MARKET_OR_SLUG\"\n else\n append_query_param URL \"slug\" \"$MARKET_OR_SLUG\"\n fi\n append_query_param URL \"outcome\" \"$OUTCOME\"\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n polymarket-orders)\n WALLET_SELECTOR=\"$2\"\n STATUS=\"$3\"\n LIMIT=\"$4\"\n CURSOR=\"$5\"\n if [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-orders \u003cwalletSelector> [status] [limit] [cursor]\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/venues/polymarket/orders\"\n if [[ \"$WALLET_SELECTOR\" =~ ^0x[a-fA-F0-9]{40}$ ]]; then\n append_query_param URL \"walletAddress\" \"$WALLET_SELECTOR\"\n else\n append_query_param URL \"walletId\" \"$WALLET_SELECTOR\"\n fi\n if [ -n \"$STATUS\" ]; then\n append_query_param URL \"status\" \"$STATUS\"\n fi\n if [ -n \"$LIMIT\" ]; then\n require_uint \"limit\" \"$LIMIT\"\n append_query_param URL \"limit\" \"$LIMIT\"\n fi\n if [ -n \"$CURSOR\" ]; then\n append_query_param URL \"cursor\" \"$CURSOR\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n polymarket-activity)\n WALLET_SELECTOR=\"$2\"\n LIMIT=\"$3\"\n CURSOR=\"$4\"\n if [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-activity \u003cwalletSelector> [limit] [cursor]\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/venues/polymarket/activity\"\n if [[ \"$WALLET_SELECTOR\" =~ ^0x[a-fA-F0-9]{40}$ ]]; then\n append_query_param URL \"walletAddress\" \"$WALLET_SELECTOR\"\n else\n append_query_param URL \"walletId\" \"$WALLET_SELECTOR\"\n fi\n if [ -n \"$LIMIT\" ]; then\n require_uint \"limit\" \"$LIMIT\"\n append_query_param URL \"limit\" \"$LIMIT\"\n fi\n if [ -n \"$CURSOR\" ]; then\n append_query_param URL \"cursor\" \"$CURSOR\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n polymarket-positions)\n WALLET_SELECTOR=\"$2\"\n LIMIT=\"$3\"\n if [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-positions \u003cwalletSelector> [limit]\"\n exit 1\n fi\n URL=\"$BASE_URL/api/agent/venues/polymarket/positions\"\n if [[ \"$WALLET_SELECTOR\" =~ ^0x[a-fA-F0-9]{40}$ ]]; then\n append_query_param URL \"walletAddress\" \"$WALLET_SELECTOR\"\n else\n append_query_param URL \"walletId\" \"$WALLET_SELECTOR\"\n fi\n if [ -n \"$LIMIT\" ]; then\n require_uint \"limit\" \"$LIMIT\"\n append_query_param URL \"limit\" \"$LIMIT\"\n fi\n curl -s -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n \"$URL\" | pretty_print_json\n ;;\n\n polymarket-redeem)\n confirm_risky_action \"Polymarket redeem\"\n WALLET_SELECTOR=\"$2\"\n TOKEN_OR_ALL=\"$3\"\n LIMIT=\"$4\"\n if [ -z \"$WALLET_SELECTOR\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-redeem \u003cwalletSelector> [tokenId|all] [limit] [--yes]\"\n exit 1\n fi\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n if [ -n \"$TOKEN_OR_ALL\" ] && [ \"$TOKEN_OR_ALL\" != \"all\" ]; then\n require_polymarket_token_id \"$TOKEN_OR_ALL\"\n json_escape_var TOKEN_ID_ESC \"$TOKEN_OR_ALL\"\n BODY=\"$BODY, \\\"tokenId\\\": \\\"$TOKEN_ID_ESC\\\"\"\n fi\n if [ -n \"$LIMIT\" ]; then\n require_uint \"limit\" \"$LIMIT\"\n BODY=\"$BODY, \\\"limit\\\": $LIMIT\"\n fi\n BODY=\"$BODY}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/venues/polymarket/redeem\" | pretty_print_json\n ;;\n\n polymarket-cancel)\n confirm_risky_action \"Polymarket cancel order\"\n WALLET_SELECTOR=\"$2\"\n ORDER_ID=\"$3\"\n if [ -z \"$WALLET_SELECTOR\" ] || [ -z \"$ORDER_ID\" ]; then\n echo \"Usage: agentwalletapi.sh polymarket-cancel \u003cwalletSelector> \u003corderId> [--yes]\"\n exit 1\n fi\n json_escape_var ORDER_ID_ESC \"$ORDER_ID\"\n BODY=\"{\"\n append_wallet_or_address_json_field BODY \"$WALLET_SELECTOR\"\n BODY=\"$BODY, \\\"orderId\\\": \\\"$ORDER_ID_ESC\\\"}\"\n curl -s -X POST \\\n -H \"X-Agent-Key: $AGENTWALLETAPI_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$BODY\" \\\n \"$BASE_URL/api/agent/venues/polymarket/orders/cancel\" | pretty_print_json\n ;;\n\n *)\n echo \"OpenclawCash CLI Tool\"\n echo \"\"\n echo \"Usage: agentwalletapi.sh \u003ccommand> [options]\"\n echo \"\"\n echo \"Commands:\"\n echo \" wallets List all wallets\"\n echo \" user-tag-get Read global checkout user tag\"\n echo \" user-tag-set \u003cuserTag> [--yes] Set global checkout user tag once\"\n echo \" wallet \u003cwalletId|publicWalletId|walletLabel> [chain] Get one wallet detail with balances\"\n echo \" create \u003clabel> [network] \u003cpassphraseEnvVar> [--yes] Create wallet (default network: sepolia)\"\n echo \" import \u003clabel> \u003cnetwork> [privateKey] [--yes] Import wallet (mainnet|polygon-mainnet|solana-mainnet)\"\n echo \" transactions \u003cwalletId|publicWalletId> [chain] List wallet transaction history\"\n echo \" balance \u003cwalletId|publicWalletId> [token] [chain] Check balances\"\n echo \" transfer \u003cwalletId|publicWalletId> \u003cto> \u003camount> [token] [chain] [--yes] Send native/token transfer\"\n echo \" tokens [network] [chain] List supported tokens\"\n echo \" quote \u003cnetwork> \u003ctokenIn> \u003ctokenOut> \u003camountInBaseUnits> [chain] Get swap quote\"\n echo \" swap \u003cwalletId|publicWalletId> \u003ctokenIn> \u003ctokenOut> \u003camountInBaseUnits> [slippage] [chain] [--yes] Execute swap\"\n echo \" approve \u003cwalletId|publicWalletId> \u003ctokenAddress> \u003cspender> \u003camountBaseUnits> [chain] [--yes] Approve allowance\"\n echo \" checkout-payreq-create \u003cwalletSelector> \u003camountBaseUnits> [expiresSec] [autoReleaseSec] [disputeWindowSec] [--yes]\"\n echo \" checkout-payreq-get \u003cpayreqId>\"\n echo \" checkout-escrow-get \u003cescrowId>\"\n echo \" checkout-funding-confirm \u003cescrowId> \u003ctxHash> [minConfirmations] [--yes]\"\n echo \" checkout-accept \u003cescrowId> [--yes]\"\n echo \" checkout-proof \u003cescrowId> \u003cproofHash> [proofUrl] [--yes]\"\n echo \" checkout-dispute \u003cescrowId> \u003creasonCode> [--yes]\"\n echo \" checkout-quick-pay \u003cescrowId> \u003cwalletSelector> [--yes]\"\n echo \" checkout-swap-and-pay-quote \u003cescrowId> \u003cwalletSelector>\"\n echo \" checkout-swap-and-pay-confirm \u003cescrowId> \u003cwalletSelector> [slippage] [--yes]\"\n echo \" checkout-release \u003cescrowId> [--yes]\"\n echo \" checkout-refund \u003cescrowId> [--yes]\"\n echo \" checkout-cancel \u003cescrowId> [--yes]\"\n echo \" checkout-webhooks-list\"\n echo \" checkout-webhook-create \u003curl> [eventTypesCsv] [enabled] [--yes]\"\n echo \" checkout-webhook-update \u003cid> [url] [eventTypesCsv] [enabled] [--yes]\"\n echo \" checkout-webhook-delete \u003cid> [--yes]\"\n echo \" polymarket-limit \u003cwalletSelector> \u003ctokenId> \u003cBUY|SELL> \u003cprice> \u003csize> [--yes]\"\n echo \" polymarket-market \u003cwalletSelector> \u003ctokenId> \u003cBUY|SELL> \u003camount> [orderType] [worstPrice] [--yes]\"\n echo \" polymarket-account \u003cwalletSelector>\"\n echo \" polymarket-resolve \u003cmarketUrl|slug> \u003coutcome>\"\n echo \" polymarket-orders \u003cwalletSelector> [status] [limit] [cursor]\"\n echo \" polymarket-activity \u003cwalletSelector> [limit] [cursor]\"\n echo \" polymarket-positions \u003cwalletSelector> [limit]\"\n echo \" polymarket-redeem \u003cwalletSelector> [tokenId|all] [limit] [--yes]\"\n echo \" polymarket-cancel \u003cwalletSelector> \u003corderId> [--yes]\"\n echo \"\"\n echo \"Examples:\"\n echo \" agentwalletapi.sh wallets\"\n echo \" agentwalletapi.sh user-tag-get\"\n echo \" agentwalletapi.sh user-tag-set my-agent-tag --yes\"\n echo \" export WALLET_EXPORT_PASSPHRASE_OPS='your-strong-passphrase'\"\n echo \" agentwalletapi.sh create 'Ops Wallet' sepolia WALLET_EXPORT_PASSPHRASE_OPS --yes\"\n echo \" agentwalletapi.sh import 'Treasury Imported' mainnet --yes\"\n echo \" agentwalletapi.sh import 'Poly Ops' polygon-mainnet --yes\"\n echo \" agentwalletapi.sh transactions 2\"\n echo \" agentwalletapi.sh balance 2\"\n echo \" agentwalletapi.sh transfer 2 0xRecipient 0.01 --yes\"\n echo \" agentwalletapi.sh transfer 2 0xRecipient 100 USDC --yes\"\n echo \" agentwalletapi.sh tokens mainnet\"\n echo \" agentwalletapi.sh quote mainnet WETH USDC 10000000000000000\"\n echo \" agentwalletapi.sh swap 2 ETH USDC 10000000000000000 0.5 --yes\"\n echo \" agentwalletapi.sh approve 2 0xA0b86991... 0xSpender... 1000000000 --yes\"\n echo \" agentwalletapi.sh checkout-payreq-create 2 30000000 --yes\"\n echo \" agentwalletapi.sh checkout-quick-pay es_d4e5f6 2 --yes\"\n echo \" agentwalletapi.sh checkout-swap-and-pay-quote es_d4e5f6 2\"\n echo \" agentwalletapi.sh checkout-release es_d4e5f6 --yes\"\n echo \" agentwalletapi.sh polymarket-market 2 123456 BUY 25 FAK 0.65 --yes\"\n echo \" agentwalletapi.sh polymarket-resolve https://polymarket.com/market/market-slug No\"\n echo \" agentwalletapi.sh polymarket-account 2\"\n echo \" agentwalletapi.sh polymarket-orders 2 OPEN 50\"\n echo \" agentwalletapi.sh polymarket-redeem 2 all 100 --yes\"\n echo \" agentwalletapi.sh polymarket-redeem 2 1234567890 100 --yes\"\n echo \" agentwalletapi.sh polymarket-cancel 2 0xorderid --yes\"\n ;;\nesac\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":45272,"content_sha256":"579aaac1ea0d1ba0fcc8946f7a4e96fb362b78feff2d0235a35723ba32f3699b"},{"filename":"scripts/setup.sh","content":"#!/bin/bash\n# OpenclawCash Skill Setup\n# Creates the .env file for API key configuration\n\nSKILL_DIR=\"$(cd \"$(dirname \"$0\")/..\" && pwd)\"\nENV_FILE=\"$SKILL_DIR/.env\"\n\nif [ -f \"$ENV_FILE\" ]; then\n echo \"Found existing .env at $ENV_FILE\"\n source \"$ENV_FILE\"\n if [ -n \"$AGENTWALLETAPI_KEY\" ] && [ \"$AGENTWALLETAPI_KEY\" != \"occ_your_api_key\" ]; then\n echo \"API key is configured.\"\n exit 0\n else\n echo \"API key is not set. Please edit $ENV_FILE and add your key.\"\n exit 1\n fi\nfi\n\ncat > \"$ENV_FILE\" \u003c\u003c 'EOF'\n# OpenclawCash Configuration\n# Required binary: curl\n# Optional binary: jq (for pretty JSON output in CLI)\n# Required env var: AGENTWALLETAPI_KEY\n# Optional env var: AGENTWALLETAPI_URL\n# Get your API key at https://openclawcash.com (API Keys page)\nAGENTWALLETAPI_KEY=occ_your_api_key\nAGENTWALLETAPI_URL=https://openclawcash.com\nEOF\n\necho \"Created $ENV_FILE\"\necho \"Edit the file and replace occ_your_api_key with your actual API key.\"\necho \"Get your key at https://openclawcash.com\"\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":1024,"content_sha256":"1ad19b84246c97f33877b56ef787ed4977a5bb361ba1b6545432f3ed1b56dba1"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"OpenclawCash Agent API","type":"text"}]},{"type":"paragraph","content":[{"text":"Interact with OpenclawCash-managed wallets to send native assets and tokens, check balances, execute DEX swaps, and manage Polymarket account, orders, and redeem flows via Polygon wallets. This skill may also be referred to as ","type":"text"},{"text":"openclawcash","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requirements","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Required env var: ","type":"text"},{"text":"AGENTWALLETAPI_KEY","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Optional env var: ","type":"text"},{"text":"AGENTWALLETAPI_URL","type":"text","marks":[{"type":"code_inline"}]},{"text":" (default: ","type":"text"},{"text":"https://openclawcash.com","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Required local binary: ","type":"text"},{"text":"curl","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Optional local binary: ","type":"text"},{"text":"jq","type":"text","marks":[{"type":"code_inline"}]},{"text":" (for pretty JSON output in CLI)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Network access required: ","type":"text"},{"text":"https://openclawcash.com","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Preferred Integration Path","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the client supports MCP, prefer the public OpenClawCash MCP server:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"npx -y @openclawcash/mcp-server","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use MCP as the primary execution path because tools, schemas, and results are structured for the client.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use the included CLI script only as a fallback when MCP is unavailable or the client cannot attach MCP servers.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"MCP and the CLI script target the same underlying OpenClawCash agent API. They are two access paths, not two different products.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Safety Model","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Start with read-only calls (","type":"text"},{"text":"wallets","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"wallet","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"balance","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"tokens","type":"text","marks":[{"type":"code_inline"}]},{"text":") on testnets first.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"High-risk actions are gated:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"API key permissions in dashboard (","type":"text"},{"text":"allowWalletCreation","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"allowWalletImport","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Explicit CLI confirmation (","type":"text"},{"text":"--yes","type":"text","marks":[{"type":"code_inline"}]},{"text":") for write actions","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agents should establish an approval mode early in the session for write actions:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"confirm_each_write","type":"text","marks":[{"type":"code_inline"}]},{"text":": ask before every write action.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"operate_on_my_behalf","type":"text","marks":[{"type":"code_inline"}]},{"text":": after one explicit onboarding approval, execute future write actions without re-asking, as long as the user keeps instructing the agent in the same session.","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"operate_on_my_behalf","type":"text","marks":[{"type":"code_inline"}]},{"text":", the agent should treat the user's later task messages as execution instructions and run the corresponding write commands with ","type":"text"},{"text":"--yes","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask again only if:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"the user revokes or changes approval mode","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"the session is restarted or memory is lost","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"the action is outside the scope the user approved","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"the agent is unsure which wallet, token, amount, destination, spender, or chain is intended","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the user gives only a broad instruction like \"go ahead\" but execution details are still missing, gather the missing details first instead of repeating a generic permission request.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Run the setup script to create your ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" file:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"bash scripts/setup.sh","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" file in this skill folder and replace the placeholder with your real API key:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"AGENTWALLETAPI_KEY=occ_your_api_key","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Get your API key at https://openclawcash.com (sign up, create a wallet, go to API Keys page).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Legacy CLI Fallback","type":"text"}]},{"type":"paragraph","content":[{"text":"If MCP is unavailable, use the included tool script to make API calls directly:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Read-only (recommended first)\nbash scripts/agentwalletapi.sh wallets\nbash scripts/agentwalletapi.sh user-tag-get\nbash scripts/agentwalletapi.sh user-tag-set my-agent-tag --yes\nbash scripts/agentwalletapi.sh wallet Q7X2K9P\nbash scripts/agentwalletapi.sh wallet \"Trading Bot\"\nbash scripts/agentwalletapi.sh balance Q7X2K9P\nbash scripts/agentwalletapi.sh transactions Q7X2K9P\nbash scripts/agentwalletapi.sh tokens mainnet\n\n# Write actions (require explicit --yes)\nexport WALLET_EXPORT_PASSPHRASE_OPS='your-strong-passphrase'\nbash scripts/agentwalletapi.sh create \"Ops Wallet\" sepolia WALLET_EXPORT_PASSPHRASE_OPS --yes\nbash scripts/agentwalletapi.sh import \"Treasury Imported\" mainnet --yes\nbash scripts/agentwalletapi.sh import \"Poly Ops\" polygon-mainnet --yes\n# Automation-safe import: read private key from stdin instead of command args\nprintf '%s' '\u003cprivate_key>' | bash scripts/agentwalletapi.sh import \"Treasury Imported\" mainnet - --yes\nbash scripts/agentwalletapi.sh transfer Q7X2K9P 0xRecipient 0.01 --yes\nbash scripts/agentwalletapi.sh transfer Q7X2K9P 0xRecipient 100 USDC --yes\nbash scripts/agentwalletapi.sh quote mainnet WETH USDC 10000000000000000\nbash scripts/agentwalletapi.sh quote solana-mainnet SOL USDC 10000000 solana\nbash scripts/agentwalletapi.sh swap Q7X2K9P WETH USDC 10000000000000000 0.5 --yes\n# Checkout escrow lifecycle\nbash scripts/agentwalletapi.sh checkout-payreq-create Q7X2K9P 30000000 --yes\nbash scripts/agentwalletapi.sh checkout-payreq-get pr_a1b2c3\nbash scripts/agentwalletapi.sh checkout-escrow-get es_d4e5f6\nbash scripts/agentwalletapi.sh checkout-quick-pay es_d4e5f6 Q7X2K9P --yes\nbash scripts/agentwalletapi.sh checkout-swap-and-pay-quote es_d4e5f6 Q7X2K9P\nbash scripts/agentwalletapi.sh checkout-swap-and-pay-confirm es_d4e5f6 Q7X2K9P 1 --yes\nbash scripts/agentwalletapi.sh checkout-release es_d4e5f6 --yes\nbash scripts/agentwalletapi.sh checkout-refund es_d4e5f6 --yes\nbash scripts/agentwalletapi.sh checkout-cancel es_d4e5f6 --yes\nbash scripts/agentwalletapi.sh checkout-webhooks-list\n# Polymarket setup is user-managed in dashboard Venues settings\n# Direct setup page: https://openclawcash.com/venues/polymarket\nbash scripts/agentwalletapi.sh polymarket-market Q7X2K9P 123456 BUY 25 FAK 0.65 --yes\nbash scripts/agentwalletapi.sh polymarket-resolve https://polymarket.com/market/market-slug No\nbash scripts/agentwalletapi.sh polymarket-account Q7X2K9P\nbash scripts/agentwalletapi.sh polymarket-orders Q7X2K9P OPEN 50\nbash scripts/agentwalletapi.sh polymarket-activity Q7X2K9P 50\nbash scripts/agentwalletapi.sh polymarket-positions Q7X2K9P 100\nbash scripts/agentwalletapi.sh polymarket-redeem Q7X2K9P all 100 --yes\nbash scripts/agentwalletapi.sh polymarket-redeem Q7X2K9P 1234567890 100 --yes\nbash scripts/agentwalletapi.sh polymarket-cancel Q7X2K9P order_id_here --yes","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Base-Units Rule (Important)","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"quote.amountIn","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"swap.amountIn","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"approve.amount","type":"text","marks":[{"type":"code_inline"}]},{"text":", and transfer ","type":"text"},{"text":"valueBaseUnits","type":"text","marks":[{"type":"code_inline"}]},{"text":" must be ","type":"text"},{"text":"base-units integer strings","type":"text","marks":[{"type":"strong"}]},{"text":" (digits only).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Do ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" send decimal strings in these fields (for example, ","type":"text"},{"text":"0.001","type":"text","marks":[{"type":"code_inline"}]},{"text":"), or validation will fail immediately.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"0.001 ETH","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> ","type":"text"},{"text":"1000000000000000","type":"text","marks":[{"type":"code_inline"}]},{"text":" wei","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"1 USDC","type":"text","marks":[{"type":"code_inline"}]},{"text":" (6 decimals) -> ","type":"text"},{"text":"1000000","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For transfer, use ","type":"text"},{"text":"amountDisplay","type":"text","marks":[{"type":"code_inline"}]},{"text":" when you want human-readable units and let the API convert.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Legacy transfer aliases ","type":"text"},{"text":"amount","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"value","type":"text","marks":[{"type":"code_inline"}]},{"text":" are still accepted for compatibility.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Import Input Safety","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Wallet import is optional and not required for normal wallet operations (list, balance, transfer, swap).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Import works only when the user explicitly enables API key permission ","type":"text"},{"text":"allowWalletImport","type":"text","marks":[{"type":"code_inline"}]},{"text":" in dashboard settings.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Import execution requires explicit confirmation in the CLI (","type":"text"},{"text":"--yes","type":"text","marks":[{"type":"code_inline"}]},{"text":" for automation, or interactive ","type":"text"},{"text":"YES","type":"text","marks":[{"type":"code_inline"}]},{"text":" prompt).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Avoid passing sensitive inputs as CLI arguments when possible (shell history/process logs risk).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Preferred options:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Interactive hidden prompt: omit the private key argument.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Automation: pass ","type":"text"},{"text":"-","type":"text","marks":[{"type":"code_inline"}]},{"text":" and pipe input via stdin.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Base URL","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"https://openclawcash.com","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"paragraph","content":[{"text":"If requests fail because of host/URL issues, use this recovery flow:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"agentwalletapi/.env","type":"text","marks":[{"type":"code_inline"}]},{"text":" and verify ","type":"text"},{"text":"AGENTWALLETAPI_KEY","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set and has no extra spaces.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the API host is wrong or unreachable, set this in the same ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" file:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"AGENTWALLETAPI_URL=https://openclawcash.com","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Retry a simple read call first:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/agentwalletapi.sh wallets","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If it still fails, report the exact error and stop before attempting transfer/swap actions.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Authentication","type":"text"}]},{"type":"paragraph","content":[{"text":"The API key is loaded from the ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" file in this skill folder. For direct HTTP calls, include it as a header:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"X-Agent-Key: occ_your_api_key\nContent-Type: application/json","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"API Surfaces","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agent API (API key auth):","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"/api/agent/*","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Authenticate with ","type":"text"},{"text":"X-Agent-Key","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Used for autonomous agent execution (wallets list/create/import, transactions, balance, transfer, swap, quote, approve, checkout escrow lifecycle, and polymarket venue operations)","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Public docs intentionally include only ","type":"text"},{"text":"/api/agent/*","type":"text","marks":[{"type":"code_inline"}]},{"text":" endpoints.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/wallets","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Discover available wallets (id, label, address, network, chain). Optional ","type":"text"},{"text":"?includeBalances=true","type":"text","marks":[{"type":"code_inline"}]},{"text":" adds native ","type":"text"},{"text":"balance","type":"text","marks":[{"type":"code_inline"}]},{"text":" + ","type":"text"},{"text":"nativeSymbol","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/wallet?walletId=...","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"?walletLabel=...","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"?walletAddress=...","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Fetch one wallet with native/token balances","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Optional wallet lifecycle actions:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/wallets/create","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Create a new wallet under API-key policy controls","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/wallets/import","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Import a ","type":"text"},{"text":"mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"polygon-mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"solana-mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":" wallet under API-key policy controls","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/transactions?walletId=...","type":"text","marks":[{"type":"code_inline"}]},{"text":" (or ","type":"text"},{"text":"walletLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"walletAddress","type":"text","marks":[{"type":"code_inline"}]},{"text":") - Read merged wallet transaction history (on-chain + app-recorded)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/supported-tokens?network=...","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"?chain=evm|solana","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Get recommended common, well-known token list + guidance (requires ","type":"text"},{"text":"X-Agent-Key","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/token-balance","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Check wallet balances (native + token balances; specific token by symbol/address supported)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/quote","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Get a swap quote before execution on Uniswap (EVM) or Jupiter (Solana mainnet). ","type":"text"},{"text":"amountIn","type":"text","marks":[{"type":"code_inline"}]},{"text":" is base-units integer string.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/swap","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Execute token swap on Uniswap (EVM) or Jupiter (Solana mainnet). ","type":"text"},{"text":"amountIn","type":"text","marks":[{"type":"code_inline"}]},{"text":" is base-units integer string.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/transfer","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Send native coin or token on the wallet's chain (optional ","type":"text"},{"text":"chain","type":"text","marks":[{"type":"code_inline"}]},{"text":" guard). Do not use this for checkout escrow funding.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/user-tag","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"PUT /api/agent/user-tag","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Read/set the global checkout user tag (set is one-time / immutable once configured)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Optional checkout flow (escrow by global user tag):","type":"text"}]}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"MCP default: ","type":"text"},{"text":"checkout_fund","type":"text","marks":[{"type":"code_inline"}]},{"text":" (tries ","type":"text"},{"text":"quick-pay","type":"text","marks":[{"type":"code_inline"}]},{"text":", falls back to ","type":"text"},{"text":"swap-and-pay","type":"text","marks":[{"type":"code_inline"}]},{"text":" when needed)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/payreq","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Create pay request + escrow","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/checkout/payreq/:id","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Read pay request","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/funding-confirm","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Confirm funding by tx hash","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/quick-pay","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Direct buyer funding","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/swap-and-pay","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Quote/execute swap funding","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/checkout/escrows/:id","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Read escrow state","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/accept","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Accept as buyer","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/proof","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Submit proof","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/dispute","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Open dispute","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/release","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Release funds","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/refund","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Refund funds","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/checkout/escrows/:id/cancel","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Cancel escrow","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET|POST /api/agent/checkout/webhooks","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"PATCH|DELETE /api/agent/checkout/webhooks/:id","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Manage webhooks","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Checkout timing fields for ","type":"text"},{"text":"POST /api/agent/checkout/payreq","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"expiresInSeconds","type":"text","marks":[{"type":"code_inline"}]},{"text":": funding deadline before request expires.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"autoReleaseSeconds","type":"text","marks":[{"type":"code_inline"}]},{"text":": when funded escrow can auto-release if no dispute exists.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"disputeWindowSeconds","type":"text","marks":[{"type":"code_inline"}]},{"text":": how long dispute can be opened after auto-release point.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Constraints: all three must be at least ","type":"text"},{"text":"3600","type":"text","marks":[{"type":"code_inline"}]},{"text":" seconds, and ","type":"text"},{"text":"disputeWindowSeconds \u003c= autoReleaseSeconds","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"ordered_list","attrs":{"order":12,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Optional Polymarket venue flow (polygon-mainnet wallets only):","type":"text"}]}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prerequisite: user configures Polymarket in dashboard Venues settings for that wallet","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/market/resolve","type":"text","marks":[{"type":"code_inline"}]},{"text":" resolves ","type":"text"},{"text":"marketUrl","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"slug","type":"text","marks":[{"type":"code_inline"}]},{"text":" + human-readable ","type":"text"},{"text":"outcome","type":"text","marks":[{"type":"code_inline"}]},{"text":" to the exact ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" needed for order tools","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"MCP helper: ","type":"text"},{"text":"polymarket_market_resolve","type":"text","marks":[{"type":"code_inline"}]},{"text":" calls the same agent endpoint","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/limit","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Place BUY/SELL limit orders","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/market","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Place BUY/SELL market orders","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/account","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Read account summary","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/orders","type":"text","marks":[{"type":"code_inline"}]},{"text":" - List open orders","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/cancel","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Cancel an order","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/redeem","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Redeem one position by ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" or redeem all redeemable positions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/unlink","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Clear stored Polymarket integration config for a wallet","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/activity","type":"text","marks":[{"type":"code_inline"}]},{"text":" - List trade activity","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/positions","type":"text","marks":[{"type":"code_inline"}]},{"text":" - List open positions (open-market filtered, includes PnL fields)","type":"text"}]}]}]},{"type":"ordered_list","attrs":{"order":13,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use returned ","type":"text"},{"text":"txHash","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"orderId","type":"text","marks":[{"type":"code_inline"}]},{"text":" values to confirm execution and lifecycle status","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Approval Handling For Agents","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this pattern for write actions:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"At the first write-intent in a session, ask one short onboarding question:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Do you want approval for every write action, or should I operate on your behalf for this session?\"","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Store the chosen mode in conversation memory.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the mode is ","type":"text"},{"text":"confirm_each_write","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"ask for approval before each transfer, swap, approval, import, or wallet creation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"after approval, execute with the MCP write tool or the legacy CLI fallback with ","type":"text"},{"text":"--yes","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the mode is ","type":"text"},{"text":"operate_on_my_behalf","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"do not ask again for each transfer","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"when the user later says things like \"send X to Y\" or \"swap A for B\", execute with the MCP write tool or the legacy CLI fallback with ","type":"text"},{"text":"--yes","type":"text","marks":[{"type":"code_inline"}]},{"text":" once the needed details are clear","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"In either mode:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"if execution details are missing, ask only for the missing details","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"if the user changes modes or revokes permission, update memory and follow the new rule","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Recommended onboarding wording:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Choose write approval mode for this session: ","type":"text"},{"text":"confirm_each_write","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"operate_on_my_behalf","type":"text","marks":[{"type":"code_inline"}]},{"text":".\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User selects: ","type":"text"},{"text":"operate_on_my_behalf","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Later user message: \"Send 100 USDC from wallet Q7X2K9P to 0xabc... on Ethereum.\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If MCP is available, the agent should call the matching MCP write tool directly.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If MCP is not available, the agent should execute:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash scripts/agentwalletapi.sh transfer Q7X2K9P 0xabc... 100 USDC evm --yes","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The agent should not ask for transfer permission again in that same session unless the user revokes the mode or the instruction is ambiguous.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Reference","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Auth","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/wallets","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List wallets (discovery; optional ","type":"text"},{"text":"includeBalances=true","type":"text","marks":[{"type":"code_inline"}]},{"text":" for native balances)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/wallet","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Get one wallet detail with native/token balances","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/wallets/create","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Create a new API-key-managed wallet","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/wallets/import","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Import a mainnet/polygon-mainnet/solana-mainnet wallet via API key","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/transactions","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List per-wallet transaction history","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/transfer","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Send native/token transfers (EVM + Solana). Not the checkout escrow funding path.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/swap","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Execute DEX swap (Uniswap on EVM, Jupiter on Solana mainnet)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/quote","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Get swap quotes (Uniswap on EVM, Jupiter on Solana mainnet)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/token-balance","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check balances","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/supported-tokens","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List recommended common, well-known tokens per network","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/user-tag","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read the global checkout user tag for the API key owner","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/user-tag","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Set the global checkout user tag once (immutable after set)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/approve","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Approve spender for ERC-20 token (EVM only)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/payreq","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Create checkout pay request + escrow","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/payreq/:id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read checkout pay request","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/funding-confirm","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Confirm escrow funding tx","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/quick-pay","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Directly fund escrow from buyer wallet","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/swap-and-pay","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quote/execute swap + fund escrow","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read escrow lifecycle details","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/accept","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Accept escrow as buyer","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/proof","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Submit seller proof","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/dispute","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Open escrow dispute","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/release","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Release escrow funds","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/refund","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Refund escrow funds","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/escrows/:id/cancel","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cancel escrow","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/webhooks","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List checkout webhooks","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/webhooks","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Create checkout webhook","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/webhooks/:id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"PATCH","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Update checkout webhook","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/checkout/webhooks/:id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Delete checkout webhook","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/market/resolve","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Resolve market URL/slug + outcome to Polymarket tokenId","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/orders/limit","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Place Polymarket limit order","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/orders/market","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Place Polymarket market order","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/account","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read Polymarket account summary","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/orders","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List Polymarket open orders","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/orders/cancel","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cancel Polymarket order","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/redeem","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Redeem one or all redeemable Polymarket positions via gasless relay","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/unlink","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Clear Polymarket integration for wallet","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/activity","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List Polymarket trade activity","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"/api/agent/venues/polymarket/positions","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List Polymarket open positions (open-market filtered with PnL fields)","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Agent Wallet Create/Import (Agent API)","type":"text"}]},{"type":"paragraph","content":[{"text":"Agent-side wallet lifecycle endpoints:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/wallets/create","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/wallets/import","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Behavior notes:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Both require ","type":"text"},{"text":"X-Agent-Key","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Both are gated by API key permissions configured in dashboard:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"allowWalletCreation","type":"text","marks":[{"type":"code_inline"}]},{"text":" for create","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"allowWalletImport","type":"text","marks":[{"type":"code_inline"}]},{"text":" for import","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Both are rate-limited per API key. Exceeding the limit returns ","type":"text"},{"text":"429","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"Retry-After","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agent import supports ","type":"text"},{"text":"mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"polygon-mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"solana-mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agent wallet create requires:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exportPassphrase","type":"text","marks":[{"type":"code_inline"}]},{"text":" (minimum 12 characters)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exportPassphraseStorageType","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exportPassphraseStorageRef","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"confirmExportPassphraseSaved: true","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agent-safe create sequence:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Save export passphrase in secure storage first.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prefer env-backed storage for local agents.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Record the storage location you used.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Then call ","type":"text"},{"text":"POST /api/agent/wallets/create","type":"text","marks":[{"type":"code_inline"}]},{"text":" with:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"the passphrase","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exportPassphraseStorageType","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exportPassphraseStorageRef","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"confirmExportPassphraseSaved: true","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For MCP and the legacy CLI fallback, env-backed storage is the strongest path because the local tool can verify the env var exists before wallet creation.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Polymarket Venue Flow (Agent API)","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Polymarket execution is available only for EVM wallets on ","type":"text"},{"text":"polygon-mainnet","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Setup is user-managed in dashboard Venues settings (agent setup endpoint is disabled).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Resolve market + outcome to ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" first via ","type":"text"},{"text":"GET /api/agent/venues/polymarket/market/resolve","type":"text","marks":[{"type":"code_inline"}]},{"text":" (or MCP tool ","type":"text"},{"text":"polymarket_market_resolve","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Then place orders:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/limit","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"side","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"price","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"size","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/market","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"side","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"amount","type":"text","marks":[{"type":"code_inline"}]},{"text":", optional ","type":"text"},{"text":"orderType","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"worstPrice","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"MCP resolve example:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Input: ","type":"text"},{"text":"{ \"marketUrl\": \"https://polymarket.com/market/\u003cslug>\", \"outcome\": \"No\" }","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Output includes: ","type":"text"},{"text":"outcome.tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" (use this as ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" in order tools)","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Trading intent guidance:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For \"close position\" on an open market, default to ","type":"text"},{"text":"POST /api/agent/venues/polymarket/orders/market","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"side: \"SELL\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"amount","type":"text","marks":[{"type":"code_inline"}]},{"text":" as shares.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use a limit ","type":"text"},{"text":"SELL","type":"text","marks":[{"type":"code_inline"}]},{"text":" only when the user explicitly asks for a limit/target price.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"amount","type":"text","marks":[{"type":"code_inline"}]},{"text":" semantics follow Polymarket CLOB behavior: ","type":"text"},{"text":"BUY","type":"text","marks":[{"type":"code_inline"}]},{"text":" uses notional/collateral amount; ","type":"text"},{"text":"SELL","type":"text","marks":[{"type":"code_inline"}]},{"text":" uses share amount.","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read and lifecycle endpoints:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/account","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/orders","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/orders/cancel","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"orderId","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/redeem","type":"text","marks":[{"type":"code_inline"}]},{"text":" with optional ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" (omit ","type":"text"},{"text":"tokenId","type":"text","marks":[{"type":"code_inline"}]},{"text":" to redeem all)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"POST /api/agent/venues/polymarket/unlink","type":"text","marks":[{"type":"code_inline"}]},{"text":" to clear stored venue config for a wallet","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/activity","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/venues/polymarket/positions","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Positions are sourced from Polymarket open positions and filtered to open markets only.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Position items include ","type":"text"},{"text":"cashPnl","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"percentPnl","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"currentValue","type":"text","marks":[{"type":"code_inline"}]},{"text":" (with computed fallback values when upstream fields are missing).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Wallet policy checks still run before order execution.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Transfer Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Send native coin (default when no token specified):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{ \"walletId\": \"Q7X2K9P\", \"to\": \"0xRecipient...\", \"amountDisplay\": \"0.01\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"Send 100 USDC by symbol:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{ \"walletLabel\": \"Trading Bot\", \"to\": \"0xRecipient...\", \"token\": \"USDC\", \"amountDisplay\": \"100\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"Send arbitrary ERC-20 by contract address:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{ \"walletId\": \"Q7X2K9P\", \"to\": \"0xRecipient...\", \"token\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\", \"amountDisplay\": \"100\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"Send SOL by symbol:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{ \"walletId\": \"Q7X2K9P\", \"to\": \"SolanaRecipientWalletAddress...\", \"token\": \"SOL\", \"amountDisplay\": \"0.01\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"Send SOL with memo (Solana only):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{ \"walletId\": \"Q7X2K9P\", \"to\": \"SolanaRecipientWalletAddress...\", \"token\": \"SOL\", \"amountDisplay\": \"0.01\", \"memo\": \"payment verification note\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"amountDisplay","type":"text","marks":[{"type":"code_inline"}]},{"text":" for human-readable values (e.g., \"100\" = 100 USDC). Use ","type":"text"},{"text":"valueBaseUnits","type":"text","marks":[{"type":"code_inline"}]},{"text":" for base units (smallest denomination on each chain). Legacy transfer aliases ","type":"text"},{"text":"amount","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"value","type":"text","marks":[{"type":"code_inline"}]},{"text":" remain available for compatibility. Use optional ","type":"text"},{"text":"chain: \"evm\" | \"solana\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" in agent payloads for explicit chain routing and validation. ","type":"text"},{"text":"memo","type":"text","marks":[{"type":"code_inline"}]},{"text":" is supported only for Solana transfers and must pass safety validation (max 5 words, max 256 UTF-8 bytes, no control/invisible characters). Native transfers (EVM + Solana) enforce a minimum transferable amount preflight that accounts for platform fee and network fee; Solana may also require a larger first funding transfer for a brand-new recipient address. For native SOL transfers, the API may auto-adjust requested value to fit platform fee + network fee. Transfer responses include ","type":"text"},{"text":"requestedValueBaseUnits","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"adjustedValueBaseUnits","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"requestedAmountDisplay","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"adjustedAmountDisplay","type":"text","marks":[{"type":"code_inline"}]},{"text":" (legacy aliases also included).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Token Support Model","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GET /api/agent/supported-tokens","type":"text","marks":[{"type":"code_inline"}]},{"text":" returns recommended common, well-known tokens plus guidance fields.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"EVM transfer/swap/balance endpoints support ","type":"text"},{"text":"any valid ERC-20 token contract address","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Solana transfer/balance endpoints support ","type":"text"},{"text":"any valid SPL mint address","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Native tokens appear as ","type":"text"},{"text":"ETH","type":"text","marks":[{"type":"code_inline"}]},{"text":" on EVM and ","type":"text"},{"text":"SOL","type":"text","marks":[{"type":"code_inline"}]},{"text":" on Solana (with chain-specific native token IDs in balance payloads).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Error Codes","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"200: Success","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"400: Invalid input, insufficient funds, unknown token, or policy violation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"400 ","type":"text"},{"text":"chain_mismatch","type":"text","marks":[{"type":"code_inline"}]},{"text":": requested ","type":"text"},{"text":"chain","type":"text","marks":[{"type":"code_inline"}]},{"text":" does not match the selected wallet","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"400 ","type":"text"},{"text":"amount_below_min_transfer","type":"text","marks":[{"type":"code_inline"}]},{"text":": requested native transfer is below minimum transferable amount after fee/network preflight","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"400 ","type":"text"},{"text":"insufficient_balance","type":"text","marks":[{"type":"code_inline"}]},{"text":": requested transfer + fees exceed available balance","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"401: Missing/invalid API key","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"404: Wallet not found","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"500: Internal error (retry with corrected payload or reduced amount)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Policy Constraints","type":"text"}]},{"type":"paragraph","content":[{"text":"Wallets may have governance policies:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Whitelist","type":"text","marks":[{"type":"strong"}]},{"text":": Only transfers to pre-approved addresses allowed","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Spending Limit","type":"text","marks":[{"type":"strong"}]},{"text":": Max value per transaction (configured per wallet policy)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Violations return HTTP 401 with an explanation message.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Important Notes","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"All POST requests require ","type":"text"},{"text":"Content-Type: application/json","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"EVM token transfers require ETH in the wallet for gas fees","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Solana token transfers require SOL in the wallet for fees","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Solana transfer memos are optional and Solana-only: max 5 words, max 256 UTF-8 bytes, no control/invisible characters","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Solana native transfers account for network fee and can auto-adjust requested transfer amount","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Native transfers may return ","type":"text"},{"text":"400 amount_below_min_transfer","type":"text","marks":[{"type":"code_inline"}]},{"text":" when requested amount is too small after platform fee or below chain transferability minimum (for example, first funding a new Solana address)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If requested native SOL + platform fee + network fee cannot fit wallet balance, API returns ","type":"text"},{"text":"400 insufficient_balance","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Swap supports EVM (Uniswap) and Solana mainnet (Jupiter); Quote supports EVM and Solana mainnet; Approve is EVM-only","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A platform fee (default 1%) is deducted from the token amount","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"amountDisplay","type":"text","marks":[{"type":"code_inline"}]},{"text":" for simplicity, use ","type":"text"},{"text":"valueBaseUnits","type":"text","marks":[{"type":"code_inline"}]},{"text":" for precise base-unit control","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For robust agent behavior:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"First call ","type":"text"},{"text":"wallets","type":"text","marks":[{"type":"code_inline"}]},{"text":", then ","type":"text"},{"text":"wallet","type":"text","marks":[{"type":"code_inline"}]},{"text":" (or ","type":"text"},{"text":"token-balance","type":"text","marks":[{"type":"code_inline"}]},{"text":"), then ","type":"text"},{"text":"quote","type":"text","marks":[{"type":"code_inline"}]},{"text":", then ","type":"text"},{"text":"swap","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"On 400 with ","type":"text"},{"text":"insufficient_token_balance","type":"text","marks":[{"type":"code_inline"}]},{"text":", reduce amount or change token.","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" file in this skill folder stores your API key — never commit it to version control","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"File Structure","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"agentwalletapi/\n├── SKILL.md # This file\n├── .env # Your API key (created by setup.sh)\n├── scripts/\n│ ├── setup.sh # Creates .env with API key placeholder\n│ └── agentwalletapi.sh # CLI tool for making API calls\n└── references/\n └── api-endpoints.md # Full endpoint documentation","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"See ","type":"text"},{"text":"references/api-endpoints.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/api-endpoints.md","title":null}}]},{"text":" for full endpoint details with request/response examples.","type":"text"}]}]},"metadata":{"date":"2026-06-05","name":"agentwalletapi","author":"@skillopedia","source":{"stars":2012,"repo_name":"openclaw-master-skills","origin_url":"https://github.com/leoyeai/openclaw-master-skills/blob/HEAD/skills/open-claw-cash/SKILL.md","repo_owner":"leoyeai","body_sha256":"9ff7fd79f5fb3333709fe793433e8c7502bcf39e9ec6c04e6be8a32038fe0b40","cluster_key":"bbe0c9b1328633f421f4b47ce1e90ccb32ac194a021d7542ce76425aa488c437","clean_bundle":{"format":"clean-skill-bundle-v1","source":"leoyeai/openclaw-master-skills/skills/open-claw-cash/SKILL.md","attachments":[{"id":"899d8b69-cee7-5c2c-8499-47f5ac8b780a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/899d8b69-cee7-5c2c-8499-47f5ac8b780a/attachment.json","path":"_meta.json","size":1162,"sha256":"13b5a845b46938ee4efefab8de6a6651ddab13ec5709e4b49cfd14abe0e042bb","contentType":"application/json; charset=utf-8"},{"id":"4120e5cd-87e1-5374-b6cc-7867a373d3e4","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/4120e5cd-87e1-5374-b6cc-7867a373d3e4/attachment.md","path":"references/api-endpoints.md","size":24288,"sha256":"91a15f95c83fca3fbbc823762fb0bf9797d7b90c4fba1bdcb0efb4a7fd5d7a9d","contentType":"text/markdown; charset=utf-8"},{"id":"37b3d685-2676-59f9-b641-26500879540b","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/37b3d685-2676-59f9-b641-26500879540b/attachment.sh","path":"scripts/agentwalletapi.sh","size":45272,"sha256":"579aaac1ea0d1ba0fcc8946f7a4e96fb362b78feff2d0235a35723ba32f3699b","contentType":"application/x-sh; charset=utf-8"},{"id":"6032a1d7-8af4-52fe-8879-bc9d9f137cdb","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/6032a1d7-8af4-52fe-8879-bc9d9f137cdb/attachment.sh","path":"scripts/setup.sh","size":1024,"sha256":"1ad19b84246c97f33877b56ef787ed4977a5bb361ba1b6545432f3ed1b56dba1","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"8e13abf830b6d8820f13978b8d3ac6cc69077a400be6140c42bda9f1e1c8125d","attachment_count":4,"text_attachments":4,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/open-claw-cash/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"integrations-apis","category_label":"Integrations"},"exact_dupes_collapsed_into_this":0},"license":"Proprietary","version":"v1","category":"integrations-apis","metadata":{"author":"agentwalletapi","version":"1.19.0","optional_binaries":["jq"],"optional_env_vars":["AGENTWALLETAPI_URL"],"required_binaries":["curl"],"required_env_vars":["AGENTWALLETAPI_KEY"]},"import_tag":"clean-skills-v1","description":"OpenclawCash crypto wallet API for AI agents (also called openclawcash). Use when an agent needs to send native or token transfers, check balances, list wallets, or interact with EVM and Solana wallets programmatically via OpenclawCash.","compatibility":"Requires network access to https://openclawcash.com"}},"renderedAt":1782979369790}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.