Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bitcompare-net:bitcompare-net-symbols-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Bitcompare Symbols API
summary: Crypto yield data, coin metadata, prices, market stats, and stablecoin data.
description: Public REST API powering Bitcompare and the Bitcompare MCP server. Live and historical crypto yield data across lending, staking, borrowing, and stablecoin products, plus coin metadata, aggregated prices, market stats, and stablecoin peg-stability. Every endpoint is also exposed as an MCP tool at https://api.bitcompare.net/mcp.
version: 1.0.0
contact:
name: Bitcompare API support
email: info@bitcompare.net
url: https://docs.bitcompare.net
license:
name: Commercial
url: https://bitcompare.net/terms-of-use
termsOfService: https://bitcompare.net/terms-of-use
servers:
- url: https://api.bitcompare.net
description: Production
security:
- {}
- BearerAuth: []
tags:
- name: Symbols
description: Symbol resolution and normalisation
paths:
/api/v1/symbols/resolve:
get:
tags:
- Symbols
operationId: resolve_symbol
summary: Resolve symbol to canonical coin
description: Map an exchange-specific or ambiguous symbol to bitcompare's canonical coin id. Useful when an exchange uses a non-standard ticker.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
input:
type: string
description: The raw symbol that was queried
coinId:
type: string
description: Canonical Bitcompare coin ID
symbol:
type: string
description: Canonical symbol
name:
type: string
description: Coin display name
required:
- input
- coinId
- symbol
- name
additionalProperties: true
'401':
description: Missing or invalid API key
$ref: '#/components/responses/Unauthorized'
'429':
description: Plan rate limit exceeded
$ref: '#/components/responses/RateLimited'
parameters:
- name: symbol
in: query
required: true
description: Exchange-specific or ambiguous symbol
schema:
type: string
description: Exchange-specific or ambiguous symbol
example: xbt
- name: context
in: query
required: false
description: Source exchange or quote currency to disambiguate (e.g. "kraken", "binance")
schema:
type: string
example: kraken
x-mcp-annotations:
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: true
/api/v1/symbols/resolve/batch:
post:
tags:
- Symbols
operationId: resolve_symbols_batch
summary: Batch resolve symbols
description: Resolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
resolved:
type: array
items:
type: object
properties:
input:
type: string
description: The raw symbol that was queried
coinId:
type: string
description: Canonical Bitcompare coin ID
symbol:
type: string
description: Canonical symbol
name:
type: string
description: Coin display name
required:
- input
- coinId
- symbol
- name
additionalProperties: true
required:
- resolved
additionalProperties: true
'401':
description: Missing or invalid API key
$ref: '#/components/responses/Unauthorized'
'403':
description: API key valid but plan lacks access to this endpoint
$ref: '#/components/responses/Forbidden'
'429':
description: Plan rate limit exceeded
$ref: '#/components/responses/RateLimited'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
symbols:
minItems: 1
maxItems: 100
type: array
items:
type: string
description: Up to 100 symbols to resolve in a single request
context:
description: Source exchange or quote currency applied to every input symbol
type: string
required:
- symbols
additionalProperties: true
example:
symbols:
- xbt
- weth
- wbtc
context: kraken
security:
- BearerAuth: []
x-mcp-annotations:
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: true
components:
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
properties:
message:
type: string
code:
type: string
example: INVALID_API_KEY
RateLimited:
description: Plan rate limit exceeded — see X-RateLimit-* headers and Retry-After
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
properties:
message:
type: string
code:
type: string
example: RATE_LIMIT_EXCEEDED
Forbidden:
description: API key is valid but your plan does not grant access to this endpoint (e.g. Intelligence or bulk tier required)
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
properties:
message:
type: string
code:
type: string
example: PLAN_UPGRADE_REQUIRED
upgradeUrl:
type: string
format: uri
description: Absolute URL to upgrade the plan. Always absolute (never relative to the API host).
example: https://pro.bitcompare.net/pricing
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: ck_live_*
description: 'API keys issued from https://pro.bitcompare.net/dashboard/keys. Send as `Authorization: Bearer ck_live_...`.'
externalDocs:
description: Developer documentation
url: https://docs.bitcompare.net