Coinbase

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world's transition onchain.

Finance & banking#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Coinbase Developer Platform APIs - leading the world's transition onchain.

Endpoints 185

Accounts

  • GETList accounts/v2/accountsList all accounts. The API will return all accounts that the API Key has Permissions to access. You can filter the results by using query parameters, which…
  • POSTCreate account/v2/accountsCreate an account. Two ownership modes are supported: Entity-owned: when owner is omitted, the account is owned by the Entity making the request. Returns an…
  • GETGet account/v2/accounts/:accountIdGet an account by its ID.
  • GETList balances for account/v2/accounts/:accountId/balancesList the balances for an account. Results are sorted by native-fiat equivalent balance in descending order.
  • GETGet balance for account/v2/accounts/:accountId/balances/:assetGet the balance for an account by asset.

Customers

  • GETList customers/v2/customersList all customers. The API will return all customers that the API Key has permissions to access. Results are not returned in any guaranteed order.
  • POSTCreate a customer/v2/customersCreate a new customer record. You can optionally request capabilities and submit verification requirements in the same request. This endpoint supports…
  • GETGet customer requirements/v2/customers/requirements?customerType=individual&capabilities=custodyCrypto,transferCryptoPreview the requirements a hypothetical customer of the given customerType and jurisdiction would need to satisfy to enable the requested capabilities,…
  • GETGet a customer/v2/customers/:customerIdGet a customer by their ID. Returns the full customer object.
  • PUTUpdate a customer/v2/customers/:customerIdUpdate customer information and/or request capability changes. This endpoint supports partial updates. Provide only the fields you wish to change.
  • DELETEDelete a customer/v2/customers/:customerIdInitiates deletion of the customer and all associated data. This operation is idempotent — repeated calls for an already-deleted customer return 204. A 404 is…

Deposit Destinations

  • GETList deposit destinations/v2/deposit-destinationsList deposit destinations. You can optionally filter the results by type, account ID, network, cryptocurrency address, or status. Results are sorted by…
  • POSTCreate deposit destination/v2/deposit-destinationsCreate a new deposit destination for an account. Two types are supported: crypto (public): provisions a cryptocurrency address on the requested network. The…
  • GETGet deposit destination/v2/deposit-destinations/:depositDestinationIdGet a specific deposit destination by its ID.

Disbursements

  • GETList disbursements/v2/disbursementsReturns a paginated list of disbursements accessible to your API key. Filter by status, sourceAccountId, or externalReferenceId.
  • POSTCreate a disbursement/v2/disbursementsCreates a disbursement from a CDP account you own to a Coinbase user account or an onchain address. Returns the disbursement with pending status while…
  • GETGet a disbursement/v2/disbursements/:disbursementIdReturns the disbursement identified by disbursementId. Your API key must have permission to access the disbursement.

End User Account Management

  • GETList end users/v2/end-usersLists the end users belonging to the developer's CDP Project. By default, the response is sorted by creation date in ascending order and paginated to 20 users…
  • POSTCreate end user/v2/end-usersCreates an end user. An end user is an entity that can own CDP EVM accounts, EVM smart accounts, and/or Solana accounts. 1 or more authentication methods must…
  • POSTValidate end user access token/v2/end-users/auth/validate-tokenValidates the end user's access token and returns the end user's information. Returns an error if the access token is invalid or expired. This API is intended…
  • GETGet end user/v2/end-users/:userIdGets an end user by ID. This API is intended to be used by the developer's own backend, and is authenticated using the developer's CDP API key.
  • GETLook up end users by identity/v2/end-users/lookupLooks up end users. Exactly one lookup type must be provided per request: email: searches across all email-based authentication methods (email, Google, Apple,…
  • POSTAdd EVM account to end user/v2/end-users/:userId/evmAdds a new EVM EOA account to an existing end user. End users can have up to 10 EVM accounts. This API is intended to be used by the developer's own backend,…
  • POSTAdd EVM smart account to end user/v2/end-users/:userId/evm-smart-accountCreates an EVM smart account for an existing end user. The backend will create a new EVM EOA account to serve as the owner of the smart account. This API is…
  • POSTAdd Solana account to end user/v2/end-users/:userId/solanaAdds a new Solana account to an existing end user. End users can have up to 10 Solana accounts. This API is intended to be used by the developer's own…
  • POSTImport end user private key/v2/end-users/importImports an existing private key for an end user into the developer's CDP Project. The private key must be encrypted using the CDP SDK's encryption scheme…

End User Accounts

  • GETList borrow products/v2/embedded-wallet-api/evm/borrow-productsLists the borrow products available across all supported networks and protocols. If a network and/or protocol query parameter is supplied, then borrow…
  • GETGet a borrow product/v2/embedded-wallet-api/evm/borrow-products/:borrowProductIdGets a single borrow product by its ID. The ID is a stable identifier that uniquely identifies a single borrow product based on the product's onchain…
  • POSTSign transaction via end user EVM account/v2/embedded-wallet-api/end-users/:userId/evm/sign/transactionSigns a transaction with the given end user EVM account. The transaction should be serialized as a hex string using RLP. The transaction must be an EIP-1559…
  • POSTSend transaction via end user EVM account/v2/embedded-wallet-api/end-users/:userId/evm/send/transactionSigns a transaction with the given end user EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation,…
  • POSTSend USDC on EVM/v2/embedded-wallet-api/end-users/:userId/evm/:address/send/:assetSends USDC from an end user's EVM account (EOA or Smart Account) to a recipient address on a supported EVM network. This endpoint simplifies USDC transfers by…
  • POSTSign EIP-191 message via end user EVM account/v2/embedded-wallet-api/end-users/:userId/evm/sign/messageSigns an EIP-191 message with the given end user EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)>…
  • POSTSign EIP-712 typed data via end user EVM account/v2/embedded-wallet-api/end-users/:userId/evm/sign/typed-dataSigns EIP-712 typed data with the given end user EVM account.
  • GETGet delegation for end user/v2/embedded-wallet-api/end-users/:userId/delegationReturns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using…
  • DELETERevoke delegation for end user (deprecated)/v2/embedded-wallet-api/end-users/:userId/delegationDeprecated. > Deprecation Notice: Prefer > Revoke delegation for end user > (POST /v2/embedded-wallet-api/end-users/{userId}/delegation/revoke), which takes…
  • POSTRevoke delegation for end user/v2/embedded-wallet-api/end-users/:userId/delegation/revokeRevokes all active delegations for the specified end user. This operation can be performed by the end user themselves or by a developer using their API key.
  • GETGet account-scoped delegation for end user/v2/embedded-wallet-api/end-users/:userId/address/:address/delegationReturns the active account-scoped delegation for the specified end user account, if one exists. Useful for showing delegation status in a UI. When the address…
  • POSTCreate account-scoped delegation for end user/v2/embedded-wallet-api/end-users/:userId/address/:address/delegationCreates an account-scoped delegation that allows a developer to sign on behalf of an end user for a single blockchain account (identified by its address) for…
  • DELETERevoke account-scoped delegation for end user (deprecated)/v2/embedded-wallet-api/end-users/:userId/address/:address/delegationDeprecated. > Deprecation Notice: Prefer > Revoke account-scoped delegation for end user > (POST…
  • POSTRevoke account-scoped delegation for end user/v2/embedded-wallet-api/end-users/:userId/address/:address/delegation/revokeRevokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This…
  • POSTCreate EIP-7702 delegation for end user EVM account/v2/embedded-wallet-api/end-users/:userId/evm/eip7702/delegationCreates an EIP-7702 delegation for an end user's EVM EOA account, upgrading it with smart account capabilities. This endpoint: Retrieves delegation artifacts…
  • GETGet a user operation for end user EVM Smart Account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/user-operations/:userOpHashGets a user operation by its hash for an end user's EVM Smart Account.
  • POSTSend user operation for end user Smart Account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/sendPrepares, signs, and sends a user operation for an end user's Smart Account.
  • GETList borrow positions for an end user smart account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/borrow-positionsLists the borrow positions held by an end user smart account, with the live onchain state of each position read at a point-in-time snapshot. A borrow position…
  • POSTCreate a borrow position for an end user smart account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/borrow-positionsCreates a borrow position for a specific borrow product, by posting collateral from an end user smart account and borrowing a loan against it. One position…
  • POSTAdjust a borrow position for an end user smart account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/borrow-positions/adjustAdjusts an existing borrow position for a specific borrow product by supplying collateral, withdrawing collateral, repaying debt, and/or borrowing more of the…
  • POSTClose a borrow position for an end user smart account/v2/embedded-wallet-api/end-users/:userId/evm/smart-accounts/:address/borrow-positions/closeCloses an end user smart account's borrow position by fully repaying its outstanding loan and withdrawing all remaining collateral back to the smart account,…
  • POSTSign Base64-encoded message/v2/embedded-wallet-api/end-users/:userId/solana/sign/messageSigns an arbitrary Base64 encoded message with the given Solana account. WARNING: Never sign a message that you didn't generate as it may put your funds at…
  • POSTSign transaction via end user Solana account/v2/embedded-wallet-api/end-users/:userId/solana/sign/transactionSigns a transaction with the given end user Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64.…
  • POSTSign x402 payment via end user Solana account/v2/embedded-wallet-api/end-users/:userId/solana/sign/x402-paymentSigns an x402 payment payload using the end user's given Solana account. Accepts the full x402 payment required response body from a resource server plus an…
  • POSTSend transaction via end user Solana account/v2/embedded-wallet-api/end-users/:userId/solana/send/transactionSigns a transaction with the given end user Solana account and sends it to the indicated supported network. The API handles recent blockhash management and…
  • POSTSend USDC on Solana/v2/embedded-wallet-api/end-users/:userId/solana/:address/send/:assetSends USDC from an end user's Solana account to a recipient address on the Solana network. This endpoint simplifies USDC transfers by automatically handling…

EVM Accounts

  • GETList EVM accounts/v2/evm/accountsLists the EVM accounts belonging to the developer's CDP Project. The response is paginated, and by default, returns 20 accounts per page.
  • POSTCreate EVM account/v2/evm/accountsCreates a new EVM account.
  • GETGet EVM account by address/v2/evm/accounts/:addressGets an EVM account by its address.
  • PUTUpdate EVM account/v2/evm/accounts/:addressUpdates an existing EVM account. Use this to update the account's name or account-level policy.
  • GETGet EVM account by name/v2/evm/accounts/by-name/:nameGets an EVM account by its name.
  • POSTSend transaction/v2/evm/accounts/:address/send/transactionSigns a transaction with the given EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving…
  • POSTSign transaction/v2/evm/accounts/:address/sign/transactionSigns a transaction with the given EVM account. The transaction should be serialized as a hex string using RLP. The transaction must be an EIP-1559 dynamic…
  • POSTSign hash/v2/evm/accounts/:address/signSigns an arbitrary 32 byte hash with the given EVM account.
  • POSTSign EIP-191 message/v2/evm/accounts/:address/sign/messageSigns an EIP-191 message with the given EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed…
  • POSTSign EIP-712 typed data/v2/evm/accounts/:address/sign/typed-dataSigns EIP-712 typed data with the given EVM account.
  • POSTCreate EIP-7702 delegation/v2/evm/accounts/:address/eip7702/delegationCreates an EIP-7702 delegation for an EVM EOA account, upgrading it with smart account capabilities. This endpoint: Retrieves delegation artifacts from…
  • GETGet EIP-7702 delegation operation by ID/v2/evm/eip7702/delegation-operations/:delegationOperationIdReturns the EIP-7702 delegation operation. Use the delegationOperationId returned by the Create EIP-7702 delegation endpoint to poll for operation completion.
  • POSTImport EVM account/v2/evm/accounts/importImport an existing EVM account into the developer's CDP Project. This API should be called from the CDP SDK to ensure that the associated private key is…
  • POSTExport EVM account/v2/evm/accounts/:address/exportExport an existing EVM account's private key. It is important to store the private key in a secure place after it's exported.
  • POSTExport EVM account by name/v2/evm/accounts/export/by-name/:nameExport an existing EVM account's private key by its name. It is important to store the private key in a secure place after it's exported.

EVM Smart Accounts

  • GETList Smart Accounts/v2/evm/smart-accountsLists the Smart Accounts belonging to the developer's CDP Project. The response is paginated, and by default, returns 20 accounts per page.
  • POSTCreate Smart Account/v2/evm/smart-accountsCreates a new Smart Account.
  • GETGet Smart Account by name/v2/evm/smart-accounts/by-name/:nameGets a Smart Account by its name.
  • GETGet Smart Account by address/v2/evm/smart-accounts/:addressGets a Smart Account by its address.
  • PUTUpdate EVM Smart Account/v2/evm/smart-accounts/:addressUpdates an existing EVM smart account. Use this to update the smart account's name.
  • POSTPrepare user operation/v2/evm/smart-accounts/:address/user-operationsPrepares a new user operation on a Smart Account for a specific network.
  • POSTPrepare and send user operation/v2/evm/smart-accounts/:address/user-operations/prepare-and-sendPrepares, signs, and sends a user operation for an EVM Smart Account. This API can be used only if the owner on Smart Account is a CDP EVM Account.
  • GETGet user operation/v2/evm/smart-accounts/:address/user-operations/:userOpHashGets a user operation by its hash.
  • POSTSend user operation/v2/evm/smart-accounts/:address/user-operations/:userOpHash/sendSends a user operation with a signature. The payload to sign must be the userOpHash field of the user operation. This hash should be signed directly (not…
  • POSTCreate spend permission/v2/evm/smart-accounts/:address/spend-permissionsCreates a spend permission for the given smart account address.
  • GETList spend permissions/v2/evm/smart-accounts/:address/spend-permissions/listLists spend permission for the given smart account address.
  • POSTRevoke spend permission/v2/evm/smart-accounts/:address/spend-permissions/revokeRevokes an existing spend permission.

EVM Swaps

  • GETGet swap price estimate/v2/evm/swaps/quote?network=base&toToken=0x7F5c764cBc14f9669B88837ca1490cCa17c31607&fromToken=0x6B175474E89094C44Da98b954EedeAC495271d0F&fromAmount=1000000000000000000&taker=0xAc0974bec39a17e36ba4a6b4d238ff944bacb478Get a price estimate for a swap between two tokens on an EVM network.
  • POSTCreate swap quote/v2/evm/swapsCreate a swap quote, which includes the payload to sign as well as the transaction data needed to execute the swap. The developer is responsible for signing…

EVM Token Balances

  • GETList EVM token balances/v2/evm/token-balances/:network/:addressLists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is…

Faucets

  • POSTRequest funds on EVM test networks/v2/evm/faucetRequest funds from the CDP Faucet on supported EVM test networks. Faucets are available for ETH, USDC, EURC, and cbBTC on Base Sepolia and Ethereum Sepolia,…
  • POSTRequest funds on Solana devnet/v2/solana/faucetRequest funds from the CDP Faucet on Solana devnet. Faucets are available for SOL, USDC, and CBTUSD. To prevent abuse, we enforce rate limits within a rolling…

Lend

  • GETList lend positions/v2/lend/positions?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44eLists non-zero lend positions for an EVM account or EVM Smart Account in the project. Each position reports the account's vault share balance and its current…
  • GETList vaults/v2/lend/vaultsLists the vaults created by the project. Use pageSize and pageToken to page through the results. Each vault includes its current metrics, when a metrics…
  • GETGet a vault/v2/lend/vaults/:vaultIdRetrieves a vault created by the project, including its current metrics such as APY and TVL.
  • POSTRedeem vault fees with an EVM account/v2/evm/accounts/:address/lend/redeem-feesRedeems every vault share held by the vault's fee recipient EVM account for the vault's underlying asset (e.g. USDC). The account must be the vault's fee…
  • POSTRedeem vault fees with an EVM Smart Account/v2/evm/smart-accounts/:address/lend/redeem-feesRedeems every vault share held by the vault's fee recipient EVM Smart Account for the vault's underlying asset (e.g. USDC). The Smart Account must be the…
  • POSTDeposit into a vault with an EVM account/v2/evm/accounts/:address/lend/depositDeposits the vault's underlying asset (e.g. USDC) from an EVM account into a vault. The account signs an EIP-2612 permit authorizing the deposit, and the…
  • POSTDeposit into a vault with an EVM Smart Account/v2/evm/smart-accounts/:address/lend/depositDeposits the vault's underlying asset (e.g. USDC) from an EVM Smart Account into a vault. The Smart Account's owner must be a CDP EVM account. The token…
  • POSTWithdraw from a vault with an EVM account/v2/evm/accounts/:address/lend/withdrawWithdraws the vault's underlying asset (e.g. USDC) from an EVM account's position in a vault. The account signs an EIP-2612 permit over its vault shares…
  • POSTWithdraw from a vault with an EVM Smart Account/v2/evm/smart-accounts/:address/lend/withdrawWithdraws the vault's underlying asset (e.g. USDC) from an EVM Smart Account's position in a vault. The Smart Account's owner must be a CDP EVM account. The…

Mandates

  • GETList mandates/v2/mandatesReturns a paginated list of mandates that the API key has permission to access. Filter by address (the funding source), network, and status.
  • POSTCreate a mandate/v2/mandatesCreates a mandate denominated in asset. Optionally set policy to cap debits; if omitted, a Coinbase-configured monthly max applies. The response always…
  • GETGet a mandate/v2/mandates/:mandateIdRetrieves a single mandate by its ID, including its current status, policy, and source.
  • POSTCancel a mandate/v2/mandates/:mandateId/cancelEnds the mandate off-chain. status becomes canceled, canceledAt is set, and new authorizations are blocked immediately; authorizations already in progress are…
  • GETList mandate revocations/v2/mandates/:mandateId/revocationsReturns all wallet revocations for the mandate, newest first. Each records an attempt to remove the spending allowance on-chain. A succeeded entry means the…
  • GETGet a mandate revocation/v2/mandates/:mandateId/revocations/:revocationIdRetrieves a single revocation by ID.
  • POSTRevoke a mandate with a wallet/v2/mandates/:mandateId/revocations/walletCustomer-initiated. Removes the mandate's spending allowance on-chain using the customer's signed payloads from Get wallet revocation options. The customer…
  • GETGet wallet revocation options/v2/mandates/:mandateId/revocations/wallet/optionsReturns the payloads the customer must sign to remove the mandate's spending allowance on-chain. The mandate must have an active allowance (approval…
  • GETList mandate approvals/v2/mandates/:mandateId/approvalsReturns the approvals for a mandate, most recent first. Each approval is an attempt to attach a funding source; inspect them to see why a mandate is not yet…
  • GETGet a mandate approval/v2/mandates/:mandateId/approvals/:approvalIdRetrieves a single approval by its ID, including its current status, its onchainTransactions once submitted, and, when it failed, its error. Poll this after…
  • POSTApprove a mandate with a wallet/v2/mandates/:mandateId/approvals/walletCustomer-initiated. Approves a mandate on a wallet source using the customer's signed payloads from Get wallet approval options. The customer signs the…
  • GETGet wallet approval options/v2/mandates/:mandateId/approvals/wallet/options?addresses=0xAbC1234567890aBcDeF1234567890AbCdEf123456,0xDeF9876543210FeDcBa9876543210FedcBa987654Returns the available wallet approval options for a mandate. The mandate must be in created or approval_failed status, not expired, and have no approval or…

Onchain Data

  • GETList token addresses for account/v2/data/evm/token-ownership/:network/:addressRetrieve all ERC-20 token contract addresses that an account has ever received tokens from. Analyzes transaction history to discover token interactions.
  • GETList EVM token balances/v2/data/evm/token-balances/:network/:addressLists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is…

Onramp

  • POSTInitiate onramp verification/v2/onramp/verificationsInitiates OTP verification by sending a 6-digit code to the user via the specified channel (SMS or email). Returns a verificationId that must be passed to the…
  • POSTSubmit onramp verification/v2/onramp/verifications/:verificationId/submitSubmits the OTP code to complete verification. On success, marks the verification as verified and returns the same verificationId. The destination does not…
  • POSTCreate an onramp order/v2/onramp/ordersCreate a new Onramp order or get a quote for an Onramp order. Either paymentAmount or purchaseAmount must be provided. This API supports two modes: Headless…
  • GETGet an onramp order by ID/v2/onramp/orders/:orderIdGet an onramp order by ID.
  • POSTCreate an onramp session/v2/onramp/sessionsReturns a single-use URL for an Onramp session. This API provides flexible functionality based on the parameters provided, supporting three cases: Important:…
  • POSTGet onramp user limits/v2/onramp/limitsReturns the transaction limits for an onramp user based on their payment method and user identifier. Use this API to show users their remaining purchase…
  • POSTRequest limit upgrade/v2/onramp/limits/upgradeRequests a limit upgrade for an onramp user. Only phone number is currently supported as a userId. The default API mode submits identity information directly…

Onramp (App2App)

  • POSTCreate an onramp mobile challenge/v2/onramp/mobile/sessions/challengesIssues a challenge for initiating an onramp flow from a partner mobile app. Authenticate this request from the partner backend with a CDP API key; do not…
  • POSTCreate an onramp mobile session/v2/onramp/mobile/sessionsVerifies the platform attestation for a challenge issued by Create Onramp Mobile Challenge and returns a ready-to-use onramp URL. The URL embeds the session…
  • POSTCreate an onramp iOS attestation challenge/v2/onramp/mobile/attestation/challengesIssues a one-time challenge for the iOS App Attest device-key registration step. Authenticate with a CDP API key. Call this from the partner backend and pass…
  • POSTRegister a device key for iOS App Attest/v2/onramp/mobile/attestation/registrationsVerifies an iOS App Attest attestation payload and registers the device's public key for future assertion validation. The server checks that the attestation…

Payment Methods

  • GETList payment methods/v2/payment-methodsList payment methods linked to your entity. Payment methods represent external financial instruments that can be used as a target for transfers. The list will…
  • GETGet payment method/v2/payment-methods/:paymentMethodIdGet details of a specific payment method by its ID. Returns 404 if the payment method is not found or not owned by the requesting entity.

Payment Sessions

  • GETList payment sessions/v2/payment-sessionsReturns a paginated list of payment sessions that the API key has permission to access.
  • POSTCreate a payment session/v2/payment-sessionsCreates a payment session that defines what is being paid — amount, asset, and target. Optionally configure execution behavior, expiry deadlines, redirect…
  • GETGet a payment session/v2/payment-sessions/:paymentSessionIdRetrieves a single payment session by its ID, including its current status, balances, and associated metadata. The API key must have permission to access the…
  • POSTCancel a payment session/v2/payment-sessions/:paymentSessionId/cancelCancels a payment session before any funds have been authorized or captured. The session must be in created status. Cancel is blocked while any authorization…
  • GETGet wallet authorization options/v2/payment-sessions/:paymentSessionId/authorizations/wallet/options?addresses=0xAbC1234567890aBcDeF1234567890AbCdEf123456,0xDeF9876543210FeDcBa9876543210FedcBa987654Returns the available wallet authorization options for a payment session. The session must be in created status. Provide one or more payer wallet addresses as…
  • POSTAuthorize a payment session with a wallet/v2/payment-sessions/:paymentSessionId/authorizations/walletCustomer-initiated. Authorizes a payment session using the payer's wallet. The payer signs the payloads themselves, so this call is unauthenticated. The…
  • POSTAuthorize a payment session with x402/v2/payment-sessions/:paymentSessionId/authorizations/x402Customer-initiated. Authorizes a payment session using x402. The payer supplies the payment payload, so this call is unauthenticated. The session must be in…
  • POSTAuthorize a payment session with a Coinbase account/v2/payment-sessions/:paymentSessionId/authorizations/coinbaseMerchant-initiated. The merchant charges the payer's Coinbase account using an OAuth grant the payer authorized earlier, so the payer does not need to be…
  • POSTAuthorize a payment session with a mandate/v2/payment-sessions/:paymentSessionId/authorizations/mandateMerchant-initiated. The merchant draws against a mandate in approval_succeeded status using the mandate's existing approval, so no fresh signature is required…
  • GETList payment session authorizations/v2/payment-sessions/:paymentSessionId/authorizationsReturns a paginated list of authorizations for a payment session. Each authorization represents a hold on funds and includes its current status and amount.
  • GETGet a payment session authorization/v2/payment-sessions/:paymentSessionId/authorizations/:authorizationIdRetrieves a single authorization by its ID, including its current status, amount, and any associated onchain transactions.
  • GETList payment session captures/v2/payment-sessions/:paymentSessionId/capturesReturns a paginated list of captures for a payment session. Each capture includes its status, amount, associated onchain transactions, and timestamps. Only…
  • POSTCapture a payment session/v2/payment-sessions/:paymentSessionId/capturesCaptures authorized funds. The session must have a positive capturable balance and the captureExpiresAt deadline must not have passed. This is an asynchronous…
  • GETGet a payment session capture/v2/payment-sessions/:paymentSessionId/captures/:captureIdRetrieves a single capture by its ID, including status, captured amount, associated onchain transactions, and timestamps. Only returns the capture if the API…
  • GETList payment session voids/v2/payment-sessions/:paymentSessionId/voidsReturns a paginated list of voids for a payment session. Each void includes its status, amount, associated onchain transactions, and timestamps. Only voids…
  • POSTVoid a payment session/v2/payment-sessions/:paymentSessionId/voidsReleases all remaining capturable funds back to the payer. The session must have a positive capturable balance. This is an asynchronous operation. The void is…
  • GETGet a payment session void/v2/payment-sessions/:paymentSessionId/voids/:voidIdRetrieves a single void by its ID, including status, voided amount, associated onchain transactions, and timestamps. Only returns the void if the API key has…
  • GETList payment session refunds/v2/payment-sessions/:paymentSessionId/refundsReturns a paginated list of refunds for a payment session. Each refund includes its status, amount, reason, associated onchain transactions, and timestamps.…
  • POSTRefund a payment session/v2/payment-sessions/:paymentSessionId/refundsReturns captured funds to the payer. The session must have a positive refundable balance and the refundExpiresAt deadline must not have passed. This is an…
  • GETGet a payment session refund/v2/payment-sessions/:paymentSessionId/refunds/:refundIdRetrieves a single refund by its ID, including status, refunded amount, reason, associated onchain transactions, and timestamps. Only returns the refund if…

Policy Engine

  • GETList policies/v2/policy-engine/policiesLists the policies belonging to the developer's CDP Project. Use the scope parameter to filter the policies by scope. The response is paginated, and by…
  • POSTCreate policy/v2/policy-engine/policiesCreate a policy that can be used to govern the behavior of accounts.
  • POSTSimulate policies/v2/policy-engine/simulateSimulates policy evaluation for one operation against the project's current policies and returns the action the real operation would take, the rule that…
  • GETGet policy by ID/v2/policy-engine/policies/:policyIdGet a policy by its ID.
  • PUTUpdate policy/v2/policy-engine/policies/:policyIdUpdates a policy by its ID. This will have the effect of applying the updated policy to all accounts that are currently using it.
  • DELETEDelete policy/v2/policy-engine/policies/:policyIdDelete a policy by its ID. This will have the effect of removing the policy from all accounts that are currently using it.
  • POSTPause policy/v2/policy-engine/policies/:policyId/pausePause a policy so it is skipped during evaluation as if it were not attached. The policy keeps its ID, scope, and rules. If already paused, this returns the…
  • POSTResume policy/v2/policy-engine/policies/:policyId/resumeResume a paused policy so its existing ID, scope, and rules are immediately enforced again. Resuming an active policy returns it unchanged.

Solana Accounts

  • GETList Solana accounts/v2/solana/accountsLists the Solana accounts belonging to the developer. The response is paginated, and by default, returns 20 accounts per page. If a name is provided, the…
  • POSTCreate Solana account/v2/solana/accountsCreates a new Solana account.
  • GETGet Solana account by address/v2/solana/accounts/:addressGets a Solana account by its address.
  • PUTUpdate Solana account/v2/solana/accounts/:addressUpdates an existing Solana account. Use this to update the account's name or account-level policy.
  • GETGet Solana account by name/v2/solana/accounts/by-name/:nameGets a Solana account by its name.
  • POSTImport Solana account/v2/solana/accounts/importImport an existing Solana account into the developer's CDP Project. This API should be called from the CDP SDK to ensure that the associated private key is…
  • POSTExport Solana account/v2/solana/accounts/:address/exportExport an existing Solana account's private key. It is important to store the private key in a secure place after it's exported.
  • POSTExport Solana account by name/v2/solana/accounts/export/by-name/:nameExport an existing Solana account's private key by its name. It is important to store the private key in a secure place after it's exported.
  • POSTSign transaction/v2/solana/accounts/:address/sign/transactionSigns a transaction with the given Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction…
  • POSTSign message/v2/solana/accounts/:address/sign/messageSigns an arbitrary message with the given Solana account. WARNING: Never sign a message that you didn't generate, as it can be an arbitrary transaction. For…
  • POSTSend Solana transaction/v2/solana/accounts/send/transactionSigns and sends a single Solana transaction using multiple Solana accounts. The transaction may contain contain several instructions, each of which may…

Solana Token Balances

  • GETList Solana token balances/v2/solana/token-balances/:network/:addressLists the token balances of a Solana address on a given network. The balances include SPL tokens and the native SOL token. The response is paginated, and by…

SQL API

  • POSTRun SQL Query/v2/data/query/runRun a read-only SQL query against indexed blockchain data including transactions, events, and decoded logs. This endpoint provides direct SQL access to…
  • GETGet SQL grammar/v2/data/query/grammarRetrieve the SQL grammar for the SQL API. The SQL queries that are supported by the SQL API are defined in ANTLR4 grammar which is evaluated by server before…
  • GETGet schema details/v2/data/query/schemaRetrieve the schema information for the available tables in the SQL API's indexed data. This includes table names, column definitions, data types, and indexed…

Top-Up Links

  • POSTCreate a Top-Up Link/v2/top-up-linksCreates a Top-Up Link: a shareable hosted URL that lets a payer add funds to their balance. The resource is immutable once created. The link expires 24 hours…

Transfers

  • GETList transfers/v2/transfersList transfers for your organization. Use this to view and monitor your transfer activity. Sorting: Results are sorted by creation time in descending order…
  • POSTCreate transfer/v2/transfersCreate a new transfer to move funds from a source to a target. All transfers first transition to quoted. If execute: false, the transfer stays quoted until…
  • GETGet transfer/v2/transfers/:transferIdGet a transfer by its ID.
  • POSTExecute transfer/v2/transfers/:transferId/executeExecutes a transfer which was created using the Create a transfer endpoint.
  • POSTSubmit deposit travel rule information/v2/transfers/:transferId/travel-ruleSubmit travel rule information for a deposit transfer held pending compliance review. Required fields vary by jurisdiction and may include originator name,…

Webhooks

  • GETList webhook subscriptions/v2/data/webhooks/subscriptionsRetrieve a paginated list of webhook subscriptions for the authenticated project. Returns subscriptions for all CDP product events (onchain, onramp/offramp,…
  • POSTCreate webhook subscription/v2/data/webhooks/subscriptionsSubscribe to real-time events across CDP products. A webhook subscription provides a targetURL and other relevant endpoint configuration to enable receiving…
  • GETGet webhook subscription/v2/data/webhooks/subscriptions/:subscriptionIdRetrieve detailed information about a specific webhook subscription including configuration, status, creation timestamp, and webhook signature secret.…
  • PUTUpdate webhook subscription/v2/data/webhooks/subscriptions/:subscriptionIdUpdate an existing webhook subscription's configuration including event types, target URL, filtering criteria, and enabled status. All required fields must be…
  • DELETEDelete webhook subscription/v2/data/webhooks/subscriptions/:subscriptionIdPermanently delete a webhook subscription and stop all event deliveries. This action cannot be undone. Important Notes All webhook deliveries will cease…
  • GETList webhook subscription events/v2/data/webhooks/subscriptions/:subscriptionId/eventsRetrieve webhook event delivery attempts for a specific subscription. Returns event deliveries in descending order by creation time (newest first), including…

x402 Facilitator

  • POSTVerify payment/v2/x402/verifyVerify an x402 protocol payment with a specific scheme and network.
  • POSTSettle payment/v2/x402/settleSettle an x402 protocol payment with a specific scheme and network.
  • GETGet supported payment schemes and networks/v2/x402/supportedGet the supported x402 protocol payment schemes and networks that the facilitator is able to verify and settle payments for.
  • GETList x402 resources/v2/x402/discovery/resourcesLists all active discovered x402 resources. This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their…
  • GETList merchant discovery info/v2/x402/discovery/merchant?payTo=0x742d35Cc6634C0532925a3b844Bc454e4438f44eGets x402 merchant discovery information for a given merchant payment address. This endpoint returns all active x402 resources associated with the specified…
  • GETSearch x402 resources/v2/x402/discovery/searchSearches for active x402 resources using a text query and optional filters. Supports both text-based and vector-based search depending on availability.…
  • POSTHandle MCP JSON-RPC request/v2/x402/discovery/mcpHandles JSON-RPC requests for the Model Context Protocol (MCP). Supports MCP methods for discovering x402 payment resources and tools.
  • GETList x402 bundles/v2/x402/discovery/bundlesLists the available curated x402 workflow bundles. A bundle is an ordered, named grouping of curated x402 resources that together cover a common agent…
  • GETGet an x402 bundle/v2/x402/discovery/bundles/:bundleSlugGets a single curated x402 workflow bundle by its bundle slug, including the bundle metadata and its ordered member resources joined to their full discovery…
  • POSTValidate x402 endpoint/v2/x402/validateValidates an x402 endpoint's bazaar-discovery configuration by probing the seller's URL live. Returns a uniform array of preflight check results (reachable,…

API details

Base URL
https://api.cdp.coinbase.com/platform
Authentication
A bearer token in the Authorization header
A bearer token in the Authorization header
HTTP none authentication
An API key in the X-Hook0-Signature header
Operations
185 operations on 156 pathsPOST 97GET 77PUT 6DELETE 5
2 marked deprecated
Main resources
End User Accounts 26Payment Sessions 20EVM Accounts 15EVM Smart Accounts 12Mandates 12Solana Accounts 11x402 Facilitator 10End User Account Management 9Lend 9Policy Engine 8
Response formats
application/json
Webhooks
65 described
Description format
OpenAPI 3.1.0, API version 2.0.0

How to test the Coinbase Developer Platform APIs in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Coinbase Developer Platform APIs collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List accounts” (GET /v2/accounts), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Coinbase Developer Platform APIs?

The Coinbase Developer Platform APIs - leading the world's transition onchain. It is listed under Finance & banking and has 185 endpoints.

Who publishes the Coinbase Developer Platform APIs?

It is listed from Coinbase's public API description (an OpenAPI document), not published by Coinbase on Swastik Codes. Anyone who controls coinbase.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Coinbase Developer Platform APIs?

Requests go to https://api.cdp.coinbase.com/platform. Endpoint paths are added to this base URL.

How do I authenticate with the Coinbase Developer Platform APIs?

It accepts 4 methods: A bearer token in the Authorization header; A bearer token in the Authorization header; HTTP none authentication; an API key in the X-Hook0-Signature header.

How many endpoints does the Coinbase Developer Platform APIs have?

185 operations on 156 paths (97 POST, 77 GET, 6 PUT, 5 DELETE). The largest groups are End User Accounts, Payment Sessions, EVM Accounts, EVM Smart Accounts.

Is forking the Coinbase Developer Platform APIs free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.