Coinbase API Reference

To get started check out the API Overview. Below is the documentation for each type of API call you can make.

Resources

Account Changes
All transactions, purchases, etc related to your account.

Resource Description
GET /api/v1/account_changes List all changes to your account.

Account
Singular resource to check on balance, receive addresses, etc.

Resource Description
GET /api/v1/account/balance Get the user's account balance in BTC.
GET /api/v1/account/receive_address Get the user's current bitcoin receive address.
POST /api/v1/account/generate_receive_address Generates a new bitcoin receive address for the user.

Addresses
List bitcoin addresses associated with your account.

Resource Description
GET /api/v1/addresses List bitcoin addresses associated with this account.

Oauth Applications
List and create OAuth applications

Resource Description
GET /api/v1/oauth/applications List OAuth applications on your account.
GET /api/v1/oauth/applications/:id Show an individual OAuth application.
POST /api/v1/oauth/applications Create a new OAuth application.

Authorization
Get information on your application's account access.

Resource Description
GET /api/v1/authorization Get information on your application's account access.

Buttons
Create payment buttons, pages, and iFrames to accept bitcoin on your website.

Resource Description
POST /api/v1/buttons Create a new payment button, page, or iFrame.
POST /api/v1/buttons/:code/create_order Create an order for this button.

Buys
Purchase bitcoin.

Resource Description
POST /api/v1/buys Purchase bitcoin by debiting your U.S. bank account.

Contacts
List emails the user has previously used.

Resource Description
GET /api/v1/contacts List emails the user has previously used for autocompletion.

Currencies
Show supported currencies on Coinbase and exchange rates.

Resource Description
GET /api/v1/currencies Show currencies supported by Coinbase.
GET /api/v1/currencies/exchange_rates Show exchange rates between BTC and other currencies.

Orders
List merchant orders received.

Resource Description
GET /api/v1/orders List merchant orders received.
POST /api/v1/orders Create a new order.
GET /api/v1/orders/:id_or_custom_field Show an individual merchant order.

Payment Methods
List the payment methods associated with your account.

Resource Description
GET /api/v1/payment_methods List the payment methods associated with your account.

Prices
Check the price to buy or sell bitcoin.

Resource Description
GET /api/v1/prices/buy Get the total buy price for some bitcoin amount.
GET /api/v1/prices/sell Get the total sell price for some bitcoin amount.
GET /api/v1/prices/spot_rate Get the spot price of bitcoin.
GET /api/v1/prices/historical Get the historical spot price of bitcoin in USD.

Recurring Payments
List your recurring payments (scheduled buys, sells, subscriptions, etc)

Resource Description
GET /api/v1/recurring_payments List your recurring payments.
GET /api/v1/recurring_payments/:id Show an individual recurring payment.

Reports
Generate CSV reports on account activity.

Resource Description
GET /api/v1/reports List all reports.
POST /api/v1/reports Generate a CSV report. A link to the report is sent via email and a callback event is fired.
GET /api/v1/reports/:id Show details for an individual report.

Sells
Sell bitcoin.

Resource Description
POST /api/v1/sells Sell bitcoin and receive a credit to your U.S. bank account.

Subscribers
List/show customers who have subscribed to your merchant tools.

Resource Description
GET /api/v1/subscribers List customer subscriptions.
GET /api/v1/subscribers/:id Show an individual customer subscription.

Tokens
Create and claim tokens redeemable for bitcoin.

Resource Description
POST /api/v1/tokens Create a token which can be redeemed for bitcoin
POST /api/v1/tokens/redeem Redeem a token, claiming its address and all its bitcoins

Transactions
Send money, request money, and view transaction history.

Resource Description
GET /api/v1/transactions List a user's recent transactions.
GET /api/v1/transactions/:id_or_idem_field Show details for an individual transaction.
POST /api/v1/transactions/send_money Send bitcoins to an email address or bitcoin address.
POST /api/v1/transactions/request_money Send an invoice/money request to an email address.
PUT /api/v1/transactions/:id/resend_request Resend emails for a money request.
DELETE /api/v1/transactions/:id/cancel_request Cancel a money request.
PUT /api/v1/transactions/:id/complete_request Complete a money request.

Transfers
List bitcoin buy and sell history.

Resource Description
GET /api/v1/transfers List a user's recent buys and sells.

Users
Create users.

Resource Description
POST /api/v1/users Create or signup a new user.
GET /api/v1/users Show current user with account settings.
PUT /api/v1/users/:id Update account settings for current user.
comments powered by Disqus