API

Every coinbase.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.

New to Corsair? See API access, authentication, and error handling.

Accounts

get

accounts.get Get a Coinbase account by id or currency code Risk: read

await corsair.coinbase.api.accounts.get({});

Input

Name	Type	Required	Description
`account_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	Yes	—
`name`	`string`	No	—
`primary`	`boolean`	No	—
`type`	`string`	No	—
`currency`	`string \| object`	No	—
`balance`	`object`	No	—
`created_at`	`string \| null`	No	—
`updated_at`	`string \| null`	No	—
`resource`	`string`	No	—
`resource_path`	`string`	No	—
`ready`	`boolean`	No	—

currency full type

string | {
  code: string,
  name?: string,
  type?: string,
  asset_id?: string,
  slug?: string,
  color?: string,
  exponent?: number,
  sort_index?: number,
  address_regex?: string
}

balance full type

{
  amount: string,
  currency: string
}

list

accounts.list List Coinbase accounts and balances Risk: read

await corsair.coinbase.api.accounts.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`starting_after`	`string`	No	—
`ending_before`	`string`	No	—
`order`	`asc \| desc`	No	—

Output

Name	Type	Required	Description
`pagination`	`object`	No	—
`data`	`object[]`	Yes	—

pagination full type

{
  ending_before?: string | null,
  starting_after?: string | null,
  limit?: number,
  order?: string,
  previous_uri?: string | null,
  next_uri?: string | null
}

data full type

{
  id: string,
  name?: string,
  primary?: boolean,
  type?: string,
  currency?: string | {
    code: string,
    name?: string,
    type?: string,
    asset_id?: string,
    slug?: string,
    color?: string,
    exponent?: number,
    sort_index?: number,
    address_regex?: string
  },
  balance?: {
    amount: string,
    currency: string
  },
  created_at?: string | null,
  updated_at?: string | null,
  resource?: string,
  resource_path?: string,
  ready?: boolean
}[]

Data

getExchangeRates

data.getExchangeRates Get exchange rates for a base currency Risk: read

await corsair.coinbase.api.data.getExchangeRates({});

Input

Name	Type	Required	Description
`currency`	`string`	No	—

Output

Name	Type	Required	Description
`currency`	`string`	Yes	—
`rates`	`Record<string, string>`	Yes	—

getTime

data.getTime Get Coinbase API server time Risk: read

await corsair.coinbase.api.data.getTime({});

Input: empty object Output

Name	Type	Required	Description
`iso`	`string`	Yes	—
`epoch`	`number`	Yes	—

listCurrencies

data.listCurrencies List currencies supported by Coinbase Risk: read

await corsair.coinbase.api.data.listCurrencies({});

Input: empty object Output

Name	Type	Required	Description
`data`	`object[]`	Yes	—

data full type

{
  id: string,
  name: string,
  min_size?: string,
  status?: string,
  message?: string | null,
  convertible_to?: string[]
}[]

Markets

getCurrency

markets.getCurrency Get a Coinbase App currency by id Risk: read

await corsair.coinbase.api.markets.getCurrency({});

Input

Name	Type	Required	Description
`currency_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`data`	`object`	Yes	—

data full type

{
  id: string,
  name: string,
  min_size?: string,
  status?: string,
  message?: string | null,
  convertible_to?: string[]
}

getMarketProductBook

markets.getMarketProductBook Get the Advanced Trade public product book Risk: read

await corsair.coinbase.api.markets.getMarketProductBook({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`pricebook`	`object`	No	—

pricebook full type

{
  product_id?: string,
  bids?: {
    price?: string,
    size?: string
  }[],
  asks?: {
    price?: string,
    size?: string
  }[],
  time?: string
}

getProduct

markets.getProduct Get an Advanced Trade product by id Risk: read

await corsair.coinbase.api.markets.getProduct({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`product_id`	`string`	No	—
`price`	`string`	No	—
`base_currency_id`	`string`	No	—
`quote_currency_id`	`string`	No	—
`status`	`string`	No	—
`volume_24h`	`string`	No	—

getProductBook

markets.getProductBook Get the Advanced Trade product order book Risk: read

await corsair.coinbase.api.markets.getProductBook({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`pricebook`	`object`	No	—

pricebook full type

{
  product_id?: string,
  bids?: {
    price?: string,
    size?: string
  }[],
  asks?: {
    price?: string,
    size?: string
  }[],
  time?: string
}

getPublicTrades

markets.getPublicTrades Get public Advanced Trade market trades Risk: read

await corsair.coinbase.api.markets.getPublicTrades({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`trades`	`Record<string, any>[]`	No	—
`best_bid`	`string`	No	—
`best_ask`	`string`	No	—

getServerTime

markets.getServerTime Get Coinbase Advanced Trade server time Risk: read

await corsair.coinbase.api.markets.getServerTime({});

Input: empty object Output

Name	Type	Required	Description
`iso`	`string`	No	—
`epochSeconds`	`string \| number`	No	—
`epochMillis`	`string \| number`	No	—

getTicker

markets.getTicker Get the Advanced Trade public product ticker and trades Risk: read

await corsair.coinbase.api.markets.getTicker({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`trades`	`Record<string, any>[]`	No	—
`best_bid`	`string`	No	—
`best_ask`	`string`	No	—

getVolumeSummary

markets.getVolumeSummary List Advanced Trade products including 24h volume Risk: read

await corsair.coinbase.api.markets.getVolumeSummary({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`offset`	`number`	No	—
`product_type`	`string`	No	—
`product_ids`	`string`	No	—

Output

Name	Type	Required	Description
`products`	`object[]`	No	—
`num_products`	`number`	No	—

products full type

{
  product_id?: string,
  price?: string,
  base_currency_id?: string,
  quote_currency_id?: string,
  status?: string,
  volume_24h?: string
}[]

listExchangeProducts

markets.listExchangeProducts List Advanced Trade trading products Risk: read

await corsair.coinbase.api.markets.listExchangeProducts({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`offset`	`number`	No	—
`product_type`	`string`	No	—
`product_ids`	`string`	No	—

Output

Name	Type	Required	Description
`products`	`object[]`	No	—
`num_products`	`number`	No	—

products full type

{
  product_id?: string,
  price?: string,
  base_currency_id?: string,
  quote_currency_id?: string,
  status?: string,
  volume_24h?: string
}[]

listProductCandles

markets.listProductCandles List Advanced Trade product candles Risk: read

await corsair.coinbase.api.markets.listProductCandles({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`start`	`string`	No	—
`end`	`string`	No	—
`granularity`	`string`	No	—

Output

Name	Type	Required	Description
`candles`	`object[]`	No	—

candles full type

{
  start?: string,
  low?: string,
  high?: string,
  open?: string,
  close?: string,
  volume?: string
}[]

listProducts

markets.listProducts List Advanced Trade market products Risk: read

await corsair.coinbase.api.markets.listProducts({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`offset`	`number`	No	—
`product_type`	`string`	No	—
`product_ids`	`string`	No	—

Output

Name	Type	Required	Description
`products`	`object[]`	No	—
`num_products`	`number`	No	—

products full type

{
  product_id?: string,
  price?: string,
  base_currency_id?: string,
  quote_currency_id?: string,
  status?: string,
  volume_24h?: string
}[]

listProductsCandles

markets.listProductsCandles List Advanced Trade candlestick history Risk: read

await corsair.coinbase.api.markets.listProductsCandles({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`start`	`string`	No	—
`end`	`string`	No	—
`granularity`	`string`	No	—

Output

Name	Type	Required	Description
`candles`	`object[]`	No	—

candles full type

{
  start?: string,
  low?: string,
  high?: string,
  open?: string,
  close?: string,
  volume?: string
}[]

listStats

markets.listStats Get Advanced Trade product details and 24h stats Risk: read

await corsair.coinbase.api.markets.listStats({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`product_id`	`string`	No	—
`price`	`string`	No	—
`base_currency_id`	`string`	No	—
`quote_currency_id`	`string`	No	—
`status`	`string`	No	—
`volume_24h`	`string`	No	—

listTrades

markets.listTrades List recent Advanced Trade market trades Risk: read

await corsair.coinbase.api.markets.listTrades({});

Input

Name	Type	Required	Description
`product_id`	`string`	Yes	Currency pair such as BTC-USD
`limit`	`number`	No	—

Output

Name	Type	Required	Description
`trades`	`Record<string, any>[]`	No	—
`best_bid`	`string`	No	—
`best_ask`	`string`	No	—

listWallets

markets.listWallets List Coinbase App wallets (accounts) Risk: read

await corsair.coinbase.api.markets.listWallets({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`starting_after`	`string`	No	—
`ending_before`	`string`	No	—
`order`	`asc \| desc`	No	—

Output

Name	Type	Required	Description
`pagination`	`object`	No	—
`data`	`object[]`	Yes	—

pagination full type

{
  ending_before?: string | null,
  starting_after?: string | null,
  limit?: number,
  order?: string,
  previous_uri?: string | null,
  next_uri?: string | null
}

data full type

{
  id: string,
  name?: string,
  primary?: boolean,
  type?: string,
  currency?: string | {
    code: string,
    name?: string,
    type?: string,
    asset_id?: string,
    slug?: string,
    color?: string,
    exponent?: number,
    sort_index?: number,
    address_regex?: string
  },
  balance?: {
    amount: string,
    currency: string
  },
  created_at?: string | null,
  updated_at?: string | null,
  resource?: string,
  resource_path?: string,
  ready?: boolean
}[]

Payment Methods

list

paymentMethods.list List payment methods on the authenticated Coinbase account Risk: read

await corsair.coinbase.api.paymentMethods.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`starting_after`	`string`	No	—
`ending_before`	`string`	No	—
`order`	`asc \| desc`	No	—

Output

Name	Type	Required	Description
`pagination`	`object`	No	—
`data`	`object[]`	Yes	—

pagination full type

{
  ending_before?: string | null,
  starting_after?: string | null,
  limit?: number,
  order?: string,
  previous_uri?: string | null,
  next_uri?: string | null
}

data full type

{
  id: string,
  type?: string,
  name?: string,
  currency?: string,
  primary_buy?: boolean,
  primary_sell?: boolean,
  allow_buy?: boolean,
  allow_sell?: boolean,
  allow_deposit?: boolean,
  allow_withdraw?: boolean,
  instant_buy?: boolean,
  instant_sell?: boolean,
  created_at?: string | null,
  updated_at?: string | null,
  resource?: string,
  resource_path?: string
}[]

Prices

getBuy

prices.getBuy Get the Coinbase buy price for a currency pair Risk: read

await corsair.coinbase.api.prices.getBuy({});

Input

Name	Type	Required	Description
`currency_pair`	`string`	Yes	Currency pair such as BTC-USD

Output

Name	Type	Required	Description
`amount`	`string`	Yes	—
`currency`	`string`	Yes	—
`base`	`string`	No	—

getSell

prices.getSell Get the Coinbase sell price for a currency pair Risk: read

await corsair.coinbase.api.prices.getSell({});

Input

Name	Type	Required	Description
`currency_pair`	`string`	Yes	Currency pair such as BTC-USD

Output

Name	Type	Required	Description
`amount`	`string`	Yes	—
`currency`	`string`	Yes	—
`base`	`string`	No	—

getSpot

prices.getSpot Get the current or historic spot price for a currency pair Risk: read

await corsair.coinbase.api.prices.getSpot({});

Input

Name	Type	Required	Description
`currency_pair`	`string`	Yes	Currency pair such as BTC-USD
`date`	`string`	No	Historic spot price date (YYYY-MM-DD, UTC)

Output

Name	Type	Required	Description
`amount`	`string`	Yes	—
`currency`	`string`	Yes	—
`base`	`string`	No	—

Transactions

get

transactions.get Get a transaction on a Coinbase account Risk: read

await corsair.coinbase.api.transactions.get({});

Input

Name	Type	Required	Description
`account_id`	`string`	Yes	—
`transaction_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	Yes	—
`type`	`string`	No	—
`status`	`string`	No	—
`amount`	`object`	No	—
`native_amount`	`object`	No	—
`description`	`string \| null`	No	—
`created_at`	`string \| null`	No	—
`updated_at`	`string \| null`	No	—
`resource`	`string`	No	—
`resource_path`	`string`	No	—
`instant_exchange`	`boolean`	No	—
`network`	`object`	No	—
`to`	`Record<string, any>`	No	—
`from`	`Record<string, any>`	No	—
`details`	`Record<string, any>`	No	—

amount full type

{
  amount: string,
  currency: string
}

native_amount full type

{
  amount: string,
  currency: string
}

network full type

{
  status?: string,
  hash?: string | null,
  name?: string,
  transaction_url?: string | null,
  status_description?: string | null
}

list

transactions.list List transactions for a Coinbase account Risk: read

await corsair.coinbase.api.transactions.list({});

Input

Name	Type	Required	Description
`limit`	`number`	No	—
`starting_after`	`string`	No	—
`ending_before`	`string`	No	—
`order`	`asc \| desc`	No	—
`account_id`	`string`	Yes	—

Output

Name	Type	Required	Description
`pagination`	`object`	No	—
`data`	`object[]`	Yes	—

pagination full type

{
  ending_before?: string | null,
  starting_after?: string | null,
  limit?: number,
  order?: string,
  previous_uri?: string | null,
  next_uri?: string | null
}

data full type

{
  id: string,
  type?: string,
  status?: string,
  amount?: {
    amount: string,
    currency: string
  },
  native_amount?: {
    amount: string,
    currency: string
  },
  description?: string | null,
  created_at?: string | null,
  updated_at?: string | null,
  resource?: string,
  resource_path?: string,
  instant_exchange?: boolean,
  network?: {
    status?: string,
    hash?: string | null,
    name?: string,
    transaction_url?: string | null,
    status_description?: string | null
  },
  to?: Record<string, any>,
  from?: Record<string, any>,
  details?: Record<string, any>
}[]

User

get

user.get Get the authenticated Coinbase user profile Risk: read

await corsair.coinbase.api.user.get({});

Input: empty object Output

Name	Type	Required	Description
`id`	`string`	Yes	—
`name`	`string \| null`	No	—
`username`	`string \| null`	No	—
`profile_location`	`string \| null`	No	—
`profile_bio`	`string \| null`	No	—
`profile_url`	`string \| null`	No	—
`avatar_url`	`string`	No	—
`resource`	`string`	No	—
`resource_path`	`string`	No	—
`email`	`string`	No	—
`time_zone`	`string`	No	—
`native_currency`	`string`	No	—
`bitcoin_unit`	`string`	No	—
`country`	`object`	No	—
`created_at`	`string \| null`	No	—

country full type

{
  code: string,
  name?: string
}

Overview

Plugins

Accounts

get

list

Data

getExchangeRates

getTime

listCurrencies

Markets

getCurrency

getMarketProductBook

getProduct

getProductBook

getPublicTrades

getServerTime

getTicker

getVolumeSummary

listExchangeProducts

listProductCandles

listProducts

listProductsCandles

listStats

listTrades

listWallets

Payment Methods

list

Prices

getBuy

getSell

getSpot

Transactions

get

list

User

get

​Accounts

​get

​list

​Data

​getExchangeRates

​getTime

​listCurrencies

​Markets

​getCurrency

​getMarketProductBook

​getProduct

​getProductBook

​getPublicTrades

​getServerTime

​getTicker

​getVolumeSummary

​listExchangeProducts

​listProductCandles

​listProducts

​listProductsCandles

​listStats

​listTrades

​listWallets

​Payment Methods

​list

​Prices

​getBuy

​getSell

​getSpot

​Transactions

​get

​list

​User

​get

Accounts

get

list

Data

getExchangeRates

getTime

listCurrencies

Markets

getCurrency

getMarketProductBook

getProduct

getProductBook

getPublicTrades

getServerTime

getTicker

getVolumeSummary

listExchangeProducts

listProductCandles

listProducts

listProductsCandles

listStats

listTrades

listWallets

Payment Methods

list

Prices

getBuy

getSell

getSpot

Transactions

get

list

User

get