# Coinbase API

> Coinbase provides cryptocurrency prices and market data as a workflow and API.

Get coin price returns spot, buy, and sell prices; provide a cryptocurrency name or symbol and optionally a currency.

- Page: https://fous.com/tools/coinbase
- Handle: `@coinbase`
- Category: [Blockchain](https://fous.com/tools/category/blockchain)
- Source website: https://coinbase.com
- Last verified: Sep 30, 2026

## Methods

### Get coin overview

Operation `get_coin_overview`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a cryptocurrency’s price, 24-hour change, market statistics, Coinbase popularity, trading availability, description, and website from its public Coinbase price page. Currency choices: USD, EUR, GBP, CAD, INR, BRL, SGD, AUD, MXN, ARS; missing page facts are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `coin` | string | yes | `"Solana"` | The cryptocurrency name or ticker symbol, for example Solana or SOL. |
| `currency` | string | no | `"EUR"` | Currency for prices and monetary amounts, for example EUR. Defaults to USD. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "The cryptocurrency name or ticker symbol, for example Solana or SOL.",
      "examples": [
        "Solana",
        "BTC",
        "Monero"
      ]
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency for prices and monetary amounts, for example EUR. Defaults to USD.",
      "examples": [
        "EUR"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "coin": "Solana"
    },
    {
      "coin": "BTC",
      "currency": "EUR"
    },
    {
      "coin": "Monero"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Solana"` | Cryptocurrency name. |
| `price` | number or null | `118.83` | Current price per coin in the requested currency. |
| `symbol` | string or null | `"SOL"` | Cryptocurrency ticker symbol. |
| `currency` | string | `"USD"` | Currency of all monetary values. |
| `market_cap` | number or null | `69801796573.63313` | Market capitalization in the requested currency. |
| `volume_24h` | number or null | `3971411081.2611423` | Trading volume over 24 hours in the requested currency. |
| `description` | string or null | `"Solana is a decentralized computing platform that uses SOL to pay for transactions. Solana aims to improve blockchain s` | Short plain-text description, up to 1000 characters. |
| `popularity_rank` | integer or null | `7` | Rank among tradable Coinbase assets, if shown. |
| `official_website` | string or null | `"https://solana.com/"` | Official coin website, if shown. |
| `change_24h_percent` | number or null | `-2.8249744114636597` | Price percentage change over 24 hours, signed (for example -1.5). |
| `circulating_supply` | number or null | `587853048.7477068` | Number of coins circulating. |
| `all_time_high_price` | number or null | `294.845` | Highest historical price per coin in the requested currency. |
| `coinbase_price_page` | string | `"https://www.coinbase.com/price/solana"` | Public Coinbase price page for this coin and currency. |
| `tradable_on_coinbase` | boolean or null | `true` | Whether the coin is tradable on Coinbase in the price page’s region. |

**Example input**

```json
{
  "coin": "Solana"
}
```

**Example output**

```json
{
  "name": "Solana",
  "price": 118.83,
  "symbol": "SOL",
  "currency": "USD",
  "market_cap": 69801796573.63313,
  "volume_24h": 3971411081.2611423,
  "description": "Solana is a decentralized computing platform that uses SOL to pay for transactions. Solana aims to improve blockchain scalability by using a combination of proof of stake consensus and so-called proof…",
  "popularity_rank": 7,
  "official_website": "https://solana.com/",
  "change_24h_percent": -2.8249744114636597,
  "circulating_supply": 587853048.7477068,
  "all_time_high_price": 294.845,
  "coinbase_price_page": "https://www.coinbase.com/price/solana",
  "tradable_on_coinbase": true
}
```

### Get coin price

Operation `get_coin_price`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a cryptocurrency’s current Coinbase spot, buy, and sell prices in a chosen currency. Time is when Coinbase served the price responses; quotes can change between requests.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `coin` | string | yes | `"Bitcoin"` | Cryptocurrency name or symbol, for example Bitcoin or ETH. |
| `currency` | string | no | `"Euro"` | Currency name or code, for example Euro or EUR. Defaults to USD. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency name or symbol, for example Bitcoin or ETH.",
      "examples": [
        "Bitcoin",
        "ETH"
      ]
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency name or code, for example Euro or EUR. Defaults to USD.",
      "examples": [
        "Euro"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "coin": "Bitcoin"
    },
    {
      "coin": "ETH",
      "currency": "Euro"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `time` | string | `"2026-09-29T01:49:23Z"` | UTC time when Coinbase served the prices, in ISO 8601 format. |
| `symbol` | string | `"BTC"` | Cryptocurrency symbol. |
| `buy_price` | number | `82951.115` | Coinbase buy price in the selected currency. |
| `coin_name` | string | `"Bitcoin"` | Full cryptocurrency name. |
| `page_link` | string | `"https://www.coinbase.com/price/bitcoin"` | Coinbase price page for the cryptocurrency. |
| `sell_price` | number | `82939.365` | Coinbase sell price in the selected currency. |
| `spot_price` | number | `82939.365` | Spot price in the selected currency. |
| `currency_code` | string | `"USD"` | Currency code for all three prices. |

**Example input**

```json
{
  "coin": "Bitcoin"
}
```

**Example output**

```json
{
  "time": "2026-09-29T01:49:23Z",
  "symbol": "BTC",
  "buy_price": 82951.115,
  "coin_name": "Bitcoin",
  "page_link": "https://www.coinbase.com/price/bitcoin",
  "sell_price": 82939.365,
  "spot_price": 82939.365,
  "currency_code": "USD"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@coinbase",
  "visibility": "public",
  "operation": "get_coin_overview",
  "version": 1,
  "input": {
    "coin": "Solana"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@coinbase\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_coin_overview\",\n  \"version\": 1,\n  \"input\": {\n    \"coin\": \"Solana\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@coinbase",
  "visibility": "public",
  "operation": "get_coin_overview",
  "version": 1,
  "input": {
    "coin": "Solana"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/coinbase`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_coin_overview`: Get coin overview. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_coin_price`: Get coin price. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-coinbase https://api.fous.com/mcp/tools/coinbase --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare spot, buy, and sell prices across cryptocurrencies.
- Track cryptocurrency prices in a selected currency.
- Review market capitalization and 24-hour trading volume.
- Check a coin’s 24-hour price change and all-time high.
- Identify coins available to trade on Coinbase.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Coinbase tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Coinbase account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from coinbase.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.

### What are a cryptocurrency’s current spot, buy, and sell prices?

Get coin price returns spot, buy, and sell prices for the requested cryptocurrency and currency.

### What is a coin’s 24-hour price change and market capitalization?

Get coin overview returns the 24-hour percentage change and market capitalization, along with other market details.

### Is a coin tradable on Coinbase?

Get coin overview returns whether the coin is tradable on Coinbase in the price page’s region.

## Related

- [Binance API](https://fous.com/tools/binance.md): Binance provides latest prices and rolling 24-hour statistics for active spot pairs, historical spot candles for a selected date range or newest first (up to 1,000), and current aggregated bid and ask levels.
- [CoinMarketCap API](https://fous.com/tools/coinmarketcap.md): CoinMarketCap returns prices, rankings and current Fear and Greed readings; gainers and losers include up to 30 top-100 coins above $50,000 in 24-hour volume.
- [Kraken API](https://fous.com/tools/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [CoinGecko API](https://fous.com/tools/coingecko.md): CoinGecko returns cryptocurrency prices and histories, sector rankings and details, and trending coins; non-USD historical values cover 365 days, histories 7–365 days, and today’s prices may change.
- [Kitco API](https://fous.com/tools/kitco.md): Precious metals spot prices and market coverage.
- [Google Finance API](https://fous.com/tools/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [Yahoo Finance API](https://fous.com/tools/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Investing.com API](https://fous.com/tools/investing-com.md): Investing.com provides financial markets data and news, economic releases up to 31 days, and current commodity prices and government bond yields, which may be delayed or indicative.
- [All Blockchain tools](https://fous.com/tools/category/blockchain)
