# Coinbase Transfers API **Canonical:** https://apis.io/apis/coinbase/coinbase-transfers-api/ **Provider:** Coinbase — https://apis.io/providers/coinbase/ **Base URL:** https://api.coinbase.com **Documentation:** https://www.coinbase.com/developer-platform/products/wallet-sdk Coinbase Transfers API is one of 52 APIs that [Coinbase](https://apis.io/providers/coinbase/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 12 JSON Schema definitions. Tagged areas include Transfers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 12 JSON Schemas. **Transfers** represent both the request and execution of fund transfers from a source to a target. They provide upfront fee quotes and track the complete lifecycle from initiation through completion, failure, or reversal. ## Fee Quotes Every transfer provides a comprehensive fee quote in the `fees` array. This allows you to show users exactly what they'll pay before any money moves. To review fees before execution: 1. Create a transfer with `execute: false` 2. Review the `fees` array in the response 3. Call `POST /transfers/{transferId}/execute` when ready to proceed For automatic execution without fee review, create a transfer with `execute: true`. **Fee Expiration**: Fee quotes are valid for a limited time (typically 10-15 minutes from creation). The `expiresAt` field shows exactly when the fee quote will expire. If you don't execute before this time, you'll need to create a new transfer to get updated fees. ## Fees Transfer fees vary by source, target, amount and transfer type: * **Bank fees** - Traditional banking fees for depositing funds (e.g., $15.00 wire transfer fee) * **Conversion fees** - Fees for exchanging between different assets * **Network fees** - Onchain transaction costs to complete the transfer (e.g., ETH gas fees) All fees are disclosed upfront in the `fees` array when you create a transfer. ## Transfer Lifecycle When you create a transfer, it will be in one of these statuses that determine what action you need to take: * **`quoted`** - Transfer is ready but requires manual execution via the `/execute` endpoint * **`processing`** - Transfer is being executed (no action needed - poll for completion) * **`completed`** - Transfer completed successfully * **`failed`** - Transfer failed (see `failureReason` for details) ## Execution Control * **`execute: true`**: Transfer will automatically attempt to execute * **`execute: false`**: Transfer will be created in `quoted` status and you must call the `/execute` endpoint. Use this to obtain a fee quote or validate a transfer destination before deciding whether to execute the Transfer. ## Sources and Targets * A **source** can be an Account or a Payment Method * A **target** can be an Account, Payment Method, Onchain Address, or Email Address ## Transfer Execution When a transfer reaches `completed` status, it contains the final execution details that delivered funds to the target and completion timestamps. ## Failure Reasons When a transfer fails, the `failureReason` field provides a human-readable description of what went wrong. Common failure reasons include: * "Insufficient balance to complete this transfer." * "The recipient address is invalid for the selected network." * "The recipient address failed security validation checks." * "Unable to send to this recipient." Failure reason is only present when the transfer's status is `failed`. ## Operations (5) | Method | Path | Summary | |---|---|---| | POST | `/v2/transfers` | Create transfer | | GET | `/v2/transfers` | List transfers | | GET | `/v2/transfers/{transferId}` | Get transfer | | POST | `/v2/transfers/{transferId}/execute` | Execute transfer | | POST | `/v2/transfers/{transferId}/travel-rule` | Submit deposit travel rule information | ## Machine-readable artifacts (21) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/openapi/coinbase-transfers-api-openapi.yml - **Documentation** — https://docs.cdp.coinbase.com/coinbase-app/advanced-trade-apis/rest-api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-advanced-trade-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/exchange/docs/welcome - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-exchange-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/prime/docs/rest-requests - **Documentation** — https://docs.cdp.coinbase.com/onramp/docs/welcome - **Documentation** — https://commerce.coinbase.com/docs/api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-commerce-webhooks-asyncapi.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-conversion-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-currency-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-payment-method-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transfer-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transaction-summary-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-price-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-product-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-candle-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-order-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-2-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-profile-schema.json ## Other Coinbase APIs (12) - [Coinbase Wallet SDK](https://apis.io/apis/coinbase/wallet-sdk/) - [Coinbase Data API](https://apis.io/apis/coinbase/data-api/) - [Coinbase AgentKit](https://apis.io/apis/coinbase/agentkit/) - [Coinbase Accounts API](https://apis.io/apis/coinbase/coinbase-accounts-api/) - [Coinbase Activities API](https://apis.io/apis/coinbase/coinbase-activities-api/) - [Coinbase Address Book API](https://apis.io/apis/coinbase/coinbase-address-book-api/) - [Coinbase Allocations API](https://apis.io/apis/coinbase/coinbase-allocations-api/) - [Coinbase Assets API](https://apis.io/apis/coinbase/coinbase-assets-api/) - [Coinbase Balances API](https://apis.io/apis/coinbase/coinbase-balances-api/) - [Coinbase Buy API](https://apis.io/apis/coinbase/coinbase-buy-api/) - [Coinbase Charges API](https://apis.io/apis/coinbase/coinbase-charges-api/) - [Coinbase Checkouts API](https://apis.io/apis/coinbase/coinbase-checkouts-api/) ## Tags Transfers --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/coinbase/coinbase-transfers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/coinbase/.