Get all onramp transactions

curl --request GET \
  --url https://api.developer.coinbase.com/onramp/v1/buy/transactions \
  --header 'Authorization: Bearer <token>'

{
  "next_page_key": "<string>",
  "transactions": [
    {
      "coinbase_fee": {
        "currency": "<string>",
        "value": "<string>"
      },
      "completed_at": "2023-11-07T05:31:56Z",
      "contract_address": "<string>",
      "country": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "end_partner_name": "<string>",
      "exchange_rate": {
        "currency": "<string>",
        "value": "<string>"
      },
      "failure_reason": "FAILURE_REASON_BUY_FAILED",
      "network_fee": {
        "currency": "<string>",
        "value": "<string>"
      },
      "partner_user_ref": "<string>",
      "payment_method": "UNSPECIFIED",
      "payment_subtotal": {
        "currency": "<string>",
        "value": "<string>"
      },
      "payment_total": {
        "currency": "<string>",
        "value": "<string>"
      },
      "payment_total_usd": {
        "currency": "<string>",
        "value": "<string>"
      },
      "purchase_amount": {
        "currency": "<string>",
        "value": "<string>"
      },
      "purchase_currency": "<string>",
      "purchase_network": "<string>",
      "status": "ONRAMP_TRANSACTION_STATUS_CREATED",
      "transaction_id": "<string>",
      "tx_hash": "<string>",
      "type": "ONRAMP_TRANSACTION_TYPE_BUY_AND_SEND",
      "user_id": "<string>",
      "user_type": "USER_TYPE_AUTHED",
      "wallet_address": "<string>"
    }
  ]
}

GET

buy

transactions

Get all onramp transactions

curl --request GET \
  --url https://api.developer.coinbase.com/onramp/v1/buy/transactions \
  --header 'Authorization: Bearer <token>'

{
  "next_page_key": "<string>",
  "transactions": [
    {
      "coinbase_fee": {
        "currency": "<string>",
        "value": "<string>"
      },
      "completed_at": "2023-11-07T05:31:56Z",
      "contract_address": "<string>",
      "country": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "end_partner_name": "<string>",
      "exchange_rate": {
        "currency": "<string>",
        "value": "<string>"
      },
      "failure_reason": "FAILURE_REASON_BUY_FAILED",
      "network_fee": {
        "currency": "<string>",
        "value": "<string>"
      },
      "partner_user_ref": "<string>",
      "payment_method": "UNSPECIFIED",
      "payment_subtotal": {
        "currency": "<string>",
        "value": "<string>"
      },
      "payment_total": {
        "currency": "<string>",
        "value": "<string>"
      },
      "payment_total_usd": {
        "currency": "<string>",
        "value": "<string>"
      },
      "purchase_amount": {
        "currency": "<string>",
        "value": "<string>"
      },
      "purchase_currency": "<string>",
      "purchase_network": "<string>",
      "status": "ONRAMP_TRANSACTION_STATUS_CREATED",
      "transaction_id": "<string>",
      "tx_hash": "<string>",
      "type": "ONRAMP_TRANSACTION_TYPE_BUY_AND_SEND",
      "user_id": "<string>",
      "user_type": "USER_TYPE_AUTHED",
      "wallet_address": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Query Parameters

startDate

string

Date of the oldest transaction to return e.g. 2025-01-02, 2025-01-02T15:04:05Z, 2025-01-02T15:04:05+07:00

endDate

string

Date of the newest transaction to return e.g. 2025-01-03, 2025-01-02T15:04:05Z, 2025-01-02T15:04:05+07:00

pageKey

string

Page key returned by this API for pagination

pageSize

integer<int64>

The number of transactions to return, between 1 and 1000

Response

Get All Onramp Transactions response

next_page_key

string

The page key to be passed into this API to get the next page of results

transactions

object[]

List of transactions

Show child attributes

transactions.coinbase_fee

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.coinbase_fee.currency

string

Currency symbol e.g. USD, BTC

transactions.coinbase_fee.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.completed_at

string<date-time>

The completed at timestamp

transactions.contract_address

string

The user's contact address

transactions.country

string

The user's country

transactions.created_at

string<date-time>

The created at timestamp

transactions.end_partner_name

string

The name of the developer app

transactions.exchange_rate

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.exchange_rate.currency

string

Currency symbol e.g. USD, BTC

transactions.exchange_rate.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.failure_reason

enum<string>

The reason for the transaction failure (if applicable)

Available options:

FAILURE_REASON_BUY_FAILED,

FAILURE_REASON_SEND_FAILED

transactions.network_fee

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.network_fee.currency

string

Currency symbol e.g. USD, BTC

transactions.network_fee.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.partner_user_ref

string

The partnerUserRef provided when initializing the Onramp session that created this transaction

transactions.payment_method

enum<string>

The payment method type used to purchase the crypto

Available options:

UNSPECIFIED,

CARD,

ACH_BANK_ACCOUNT,

APPLE_PAY,

FIAT_WALLET,

CRYPTO_ACCOUNT,

GUEST_CHECKOUT_CARD,

PAYPAL,

RTP,

GUEST_CHECKOUT_APPLE_PAY

transactions.payment_subtotal

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.payment_subtotal.currency

string

Currency symbol e.g. USD, BTC

transactions.payment_subtotal.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.payment_total

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.payment_total.currency

string

Currency symbol e.g. USD, BTC

transactions.payment_total.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.payment_total_usd

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.payment_total_usd.currency

string

Currency symbol e.g. USD, BTC

transactions.payment_total_usd.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.purchase_amount

object

A monetary amount represented by a decimal value and currency symbol

Show child attributes

transactions.purchase_amount.currency

string

Currency symbol e.g. USD, BTC

transactions.purchase_amount.value

string

Non-localized amount in decimal notation (e.g. 1.234)

transactions.purchase_currency

string

Purchase currency symbol e.g. ETH

transactions.purchase_network

string

Network purchased crypto will be sent on e.g. ethereum

transactions.status

enum<string>

Current status of the transaction

Available options:

ONRAMP_TRANSACTION_STATUS_CREATED,

ONRAMP_TRANSACTION_STATUS_IN_PROGRESS,

ONRAMP_TRANSACTION_STATUS_SUCCESS,

ONRAMP_TRANSACTION_STATUS_FAILED

transactions.transaction_id

string

The unique transaction ID

transactions.tx_hash

string

The tx hash of the send

transactions.type

enum<string>

The type of Onramp transaction

Available options:

ONRAMP_TRANSACTION_TYPE_BUY_AND_SEND,

ONRAMP_TRANSACTION_TYPE_SEND

transactions.user_id

string

A has of the internal user ID

transactions.user_type

enum<string>

The type of user

Available options:

USER_TYPE_AUTHED,

USER_TYPE_GUEST

transactions.wallet_address

string

The address the crypto was sent to

Get all offramp transactions

Get buy config

⌘I

CDP API V1

REST API

JSON-RPC API

Get all onramp transactions

Authorizations

Query Parameters

Response