# CoinMarketCap — Pipedream Connect

> CoinMarketCap is a website that provides cryptocurrency market cap rankings, charts, and more.

- API slug: `coinmarketcap` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Commerce
- Website: https://coinmarketcap.com/
- This page (HTML): https://pipedream.com/apps/coinmarketcap
- Tools: 4 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: coinmarketcap`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "coinmarketcap",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Get Cryptocurrency Metadata:
const result = await mcp.callTool({
  name: "coinmarketcap-get-cryptocurrency-metadata",
  arguments: {
    ids: ["Cryptocurrency IDs"],
    skipInvalid: true,
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a CoinMarketCap endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "coinmarketcap-get-cryptocurrency-metadata",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    coinmarketcap: { authProvisionId: "apn_xxxxxxx" },
    ids: ["Cryptocurrency IDs"],
    skipInvalid: true,
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (4)

### `coinmarketcap-get-cryptocurrency-metadata` — Get Cryptocurrency Metadata (Read-only)

Returns all static metadata available for one or more cryptocurrencies. See the documentation

Full schema: https://pipedream.com/apps/coinmarketcap/actions/get-cryptocurrency-metadata.md

### `coinmarketcap-id-map` — Get ID Map (V1) (Read-only)

Returns a mapping of all cryptocurrencies to unique CoinMarketCap ids. See the documentation

Full schema: https://pipedream.com/apps/coinmarketcap/actions/id-map.md

### `coinmarketcap-latest-listings` — Get Latest Listings (Read-only)

Returns a paginated list of all active cryptocurrencies with latest market data. See the documentation

Full schema: https://pipedream.com/apps/coinmarketcap/actions/latest-listings.md

### `coinmarketcap-latest-quotes` — Get Latest Quotes (Read-only)

Returns the latest market quote for 1 or more cryptocurrencies. Use the ""convert"" option to return market values in multiple fiat and cryptocurrency conversions in the same call. At least one ""id"" or ""slug"" or ""symbol"" is required for this request. See the documentation

Full schema: https://pipedream.com/apps/coinmarketcap/actions/latest-quotes.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt