# Ground > Ground developer documentation for Portfolio Wallets and webhooks. ## Docs - [Cancel a withdrawal](https://docs.groundtech.co/api-reference/portfolio-wallets/cancel-a-withdrawal.md): Cancels a reversible withdrawal. Cancellation is allowed while no payout has entered the broadcast path and no irreversible protocol exit has started. - [Create a Wallet](https://docs.groundtech.co/api-reference/portfolio-wallets/create-a-wallet.md): Creates a new wallet with the given strategy allocation. Idempotent on `requestId` — if a wallet with the same `requestId` already exists, the existing wallet is returned with `200`. A newly created wallet returns `201`. - [Get a single deposit](https://docs.groundtech.co/api-reference/portfolio-wallets/get-a-single-deposit.md): Returns a single deposit by its ID. - [Get a single withdrawal](https://docs.groundtech.co/api-reference/portfolio-wallets/get-a-single-withdrawal.md): Returns a single withdrawal by its ID. - [Get a Wallet](https://docs.groundtech.co/api-reference/portfolio-wallets/get-a-wallet.md): Returns the wallet with balances, strategy, positions, and deposit addresses. - [Get wallet yield](https://docs.groundtech.co/api-reference/portfolio-wallets/get-wallet-yield.md): Returns cumulative yield data and supporting metrics for a wallet. Use this to display "You've earned $X" and yield source APY breakdowns. - [Initiate a withdrawal](https://docs.groundtech.co/api-reference/portfolio-wallets/initiate-a-withdrawal.md): Initiates a withdrawal from the wallet. Idempotent on `requestId` — if a withdrawal with the same `requestId` already exists, the existing withdrawal is returned. Token defaults to USDC. - [List wallet activity](https://docs.groundtech.co/api-reference/portfolio-wallets/list-wallet-activity.md): Returns a cursor-paginated activity feed for a specific wallet, combining deposits and withdrawals in reverse-chronological order. - [List wallet deposits](https://docs.groundtech.co/api-reference/portfolio-wallets/list-wallet-deposits.md): Returns a cursor-paginated list of deposits for a specific wallet. - [List wallet withdrawals](https://docs.groundtech.co/api-reference/portfolio-wallets/list-wallet-withdrawals.md): Returns a cursor-paginated list of withdrawals for a specific wallet. - [List Wallets](https://docs.groundtech.co/api-reference/portfolio-wallets/list-wallets.md): Returns a cursor-paginated list of wallets for the authenticated organization. - [List yield sources](https://docs.groundtech.co/api-reference/portfolio-wallets/list-yield-sources.md): Returns the active yield source catalog available for wallet strategies. The catalog is environment-specific. - [Lookup a wallet deposit by tx hash](https://docs.groundtech.co/api-reference/portfolio-wallets/lookup-a-wallet-deposit-by-tx-hash.md): Fetch a single deposit by its onchain transaction hash. `chain` is optional; if provided, it must match the deposit's recorded chain. - [Optimize wallet strategy](https://docs.groundtech.co/api-reference/portfolio-wallets/optimize-wallet-strategy.md): Returns a yield-maximizing allocation that satisfies the supplied constraints. All request fields are optional; an empty body returns 100% to the highest-APY active source. The `allocations` array in the response has the same shape as the `strategy.allocations` input on `POST /v2/wallets`, so caller… - [Preview a withdrawal](https://docs.groundtech.co/api-reference/portfolio-wallets/preview-a-withdrawal.md): Returns the available balance for a given destination chain and, optionally, validates that a specific withdrawal amount is feasible. Token defaults to USDC. - [Update wallet strategy](https://docs.groundtech.co/api-reference/portfolio-wallets/update-wallet-strategy.md): Replaces the wallet's strategy allocation. Idempotent on `requestId` — if a strategy update with the same `requestId` and identical allocations already exists, the current wallet is returned. If `requestId` was used with different allocations, a `409 request_id_conflict` is returned. - [Ping the system](https://docs.groundtech.co/api-reference/system/ping-the-system.md): Checks the system status and returns a simple response to confirm the API is reachable. - [Create a webhook endpoint](https://docs.groundtech.co/api-reference/webhook-endpoints/create-a-webhook-endpoint.md): Registers a webhook endpoint for the authenticated organization. The signing secret is only returned in the creation response. Only `portfolio_wallet.*` event types are accepted. - [Delete a webhook endpoint](https://docs.groundtech.co/api-reference/webhook-endpoints/delete-a-webhook-endpoint.md) - [List webhook endpoints](https://docs.groundtech.co/api-reference/webhook-endpoints/list-webhook-endpoints.md) - [Agentic Installation](https://docs.groundtech.co/docs/portfolio-wallets/agentic-installation.md): Copy-paste prompts that guide an AI coding agent through a complete Ground Portfolio Wallets integration, tailored to your product type. - [API Conventions](https://docs.groundtech.co/docs/portfolio-wallets/api-conventions.md): Authentication, environments, pagination, idempotency, rate limiting, and error handling. - [Balances and Yield](https://docs.groundtech.co/docs/portfolio-wallets/balances-and-yield.md): Monitor wallet balances, positions, and yield metrics. - [Calculating Yield Accrual](https://docs.groundtech.co/docs/portfolio-wallets/calculating-yield-accrual.md): Understand how yield accrues across different position types and how to display earnings to your users. - [Create a Wallet](https://docs.groundtech.co/docs/portfolio-wallets/create-wallet.md): Create a portfolio wallet and poll for activation. - [Deposits](https://docs.groundtech.co/docs/portfolio-wallets/deposits.md): Fund a portfolio wallet and track deposit lifecycle. - [Onchain Architecture](https://docs.groundtech.co/docs/portfolio-wallets/flow-of-funds.md): How deposits and withdrawals move through Ground's on-chain contract stack. - [Portfolio Wallets Overview](https://docs.groundtech.co/docs/portfolio-wallets/introduction.md): Multi-strategy yield wallets with blended rates, automated rebalancing, and liquidity profiles. - [Optimize Strategy](https://docs.groundtech.co/docs/portfolio-wallets/optimize-strategy.md): Given customer preferences, returns a yield-maximizing allocation that plugs directly into wallet creation. - [Polling](https://docs.groundtech.co/docs/portfolio-wallets/polling.md): Examples for scheduled monitoring with list and get endpoints. - [Quickstart](https://docs.groundtech.co/docs/portfolio-wallets/quickstart.md): Create a wallet, deposit funds, and withdraw — all in 5 minutes. - [Supported Chains](https://docs.groundtech.co/docs/portfolio-wallets/supported-chains.md): Portfolio wallet deposit and withdrawal coverage. - [Transaction Approvals](https://docs.groundtech.co/docs/portfolio-wallets/transaction-approvals.md): How Turnkey transaction approvals work, how to approve them, and how to verify before signing. - [Update Strategy](https://docs.groundtech.co/docs/portfolio-wallets/update-strategy.md): Change a wallet's yield allocation after creation. - [Webhook payload examples](https://docs.groundtech.co/docs/portfolio-wallets/webhook-payload-examples.md): Example JSON bodies for Portfolio Wallet webhook events. - [Webhook signature verification](https://docs.groundtech.co/docs/portfolio-wallets/webhook-signature-verification.md): Verify Ground webhook request authenticity using Stripe-style HMAC. - [Webhooks](https://docs.groundtech.co/docs/portfolio-wallets/webhooks.md): Register webhooks and receive real-time Portfolio Wallet events. - [Withdraw Funds](https://docs.groundtech.co/docs/portfolio-wallets/withdraw-funds.md): Preview, initiate, track, and cancel portfolio wallet withdrawals. - [Yield Sources](https://docs.groundtech.co/docs/portfolio-wallets/yield-sources.md): Available yield sources, rate semantics, and liquidity expectations. ## OpenAPI Specs - [swagger-combined](https://docs.groundtech.co/swagger/swagger-combined.yaml) - [openapi](https://docs.groundtech.co/api-reference/openapi.json)