# Amberdata MCP

> Amberdata provides institutional-grade access to crypto market data, on-chain metrics, and DeFi analytics directly through your AI agent. Get real-time Spot, Futures, and Options tickers; analyze full L2 order books; query address balances and token transfers across major networks; or inspect lending protocol health. It's a unified interface for complex digital asset analysis.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** crypto-market-data, on-chain-analytics, defi-data, bitcoin-ethereum, order-book

## Description

This MCP connects your AI client to professional crypto market data. Instead of opening 10 different browser tabs—one for spot prices, one for futures spreads, another for DeFi liquidity pools, and yet another for on-chain balances—you ask your agent a single question. Your agent handles the complex retrieval across multiple asset classes and protocols, giving you a unified answer in natural language. You can query everything from historical block metrics to current best bid/ask prices, all without context switching. This depth of data is what makes Vinkius the industry standard for connecting these specialized services into one powerful catalog.

## Tools

### get_address_balances_latest
Retrieves the current native currency balance for a specified blockchain address.

### get_address_token_balances_latest
Checks the most recent holdings of ERC-20 tokens associated with an address.

### get_address_token_transfers
Gathers a historical record of token movement events for any given wallet address.

### get_blockchain_metrics_latest
Fetches the most recent block and general transaction metrics for a network.

### get_blocks_metrics_historical
Retrieves historical data detailing block-level performance and throughput over time.

### get_defi_dex_information
Provides a list of supported liquidity pools and the protocols that manage them on decentralized exchanges.

### get_defi_lending_assets_metrics_summary
Returns aggregated financial insights into assets used across various lending markets.

### get_defi_lending_protocols_information
Lists and details information for major supported lending protocols like Aave or Compound.

### get_defi_market_ohlcv_latest
Gets the latest Open, High, Low, Close, Volume data points for a specific DEX trading pair.

### get_defi_market_trades_historical
Retrieves historical tick-by-tick trade records that occurred within decentralized exchange pools.

### get_futures_ohlcv
Provides aggregated Open, High, Low, Close, Volume data for futures contracts.

### get_futures_order_book_snapshots
Gets detailed snapshots of the order book depth specifically for perpetual futures contracts.

### get_futures_tickers
Retrieves historical and latest ticker data for all types of crypto futures and perpetuals.

### get_futures_trades
Gets a stream of tick-by-tick trade executions that occurred within the futures market.

### get_options_ohlcv
Provides aggregated Open, High, Low, Close, Volume data points for options contracts.

### get_options_tickers
Retrieves key pricing metrics like Greeks and Implied Volatility for options positions.

### get_options_trades
Gets a detailed log of all tick-by-tick trades executed on the options market.

### get_spot_bid_ask_spread
Calculates and reports both absolute and percentage spreads between the best bid and ask prices for spot assets.

### get_spot_ohlcv
Retrieves aggregated Open, High, Low, Close, Volume data points for standard spot trading instruments.

### get_spot_order_book_events
Gets incremental updates (deltas) showing changes to the L2 order book depth in real time for a spot asset.

### get_spot_order_book_snapshots
Provides full, minute-by-minute snapshots of the entire order book for a spot instrument.

### get_spot_reference_rates
Retrieves internationally recognized benchmark prices for major assets like BTC and ETH (SOC I/II compliant).

### get_spot_tickers
Gets the historical and latest best bid/ask quotes for a spot asset.

### get_spot_trade_frequency
Calculates trade counts grouped by size categories to gauge trading activity volume.

### get_spot_trade_pressure
Determines net trade data, showing the ratio of aggressive buy versus sell orders at a spot level.

### get_spot_trades
Retrieves a detailed log of every executed transaction that occurred on a spot instrument.

### get_spot_vwap_twap
Calculates the Volume-Weighted Average Price (VWAP) and Time-Weighted Average Price (TWAP) for a specified asset.

### get_transactions_metrics_historical
Gathers historical data on transaction volume, fees, and other network metrics at the transaction level.

## Prompt Examples

**Prompt:** 
```
Get the latest spot tickers for 'btc_usd_coinbase'.
```

**Response:** 
```
I've retrieved the latest tickers for BTC-USD on Coinbase. The current best bid is $65,432.10 and the best ask is $65,433.50.
```

**Prompt:** 
```
Show me the latest blockchain metrics for Ethereum.
```

**Response:** 
```
Fetching Ethereum network stats... Currently, the block height is 19,234,567 with an average transaction count of 150 per block in the last hour.
```

**Prompt:** 
```
List the available DeFi lending protocols.
```

**Response:** 
```
I've found several active protocols including Aave, Compound, and MakerDAO. Would you like to see specific metrics for one of these?
```

## Capabilities

### Determine real-time market liquidity depth
Access full L2 order book snapshots and event deltas for deep analysis of current market buying and selling pressure.

### Track asset positions and historical flows
Get a complete picture of an address's holdings, including both native currency balances and ERC-20 token transfers over time.

### Analyze derivatives pricing across markets
Retrieve aggregated OHLCV data for futures contracts, options, and perpetual swaps to model complex risk scenarios.

### Assess decentralized finance (DeFi) health
Query metrics on lending protocols (like Aave or Compound) and list supported liquidity pools across various DEXs.

### Calculate specialized asset pricing indicators
Retrieve benchmark reference rates compliant with SOC I/II, or calculate Volume-Weighted Average Price (VWAP) for specific instruments.

## Use Cases

### Pinpointing Arbitrage Opportunities
A quant trader needs to know if the perpetual futures price is drifting too far from the spot price. They ask their agent: 'Compare the latest `get_spot_ohlcv` data for ETH/USD against the `get_futures_tickers` data.' The MCP runs both tools and provides a delta calculation, confirming an actionable spread.

### Auditing Token Movements
A compliance officer must verify if a wallet received tokens from a specific smart contract. They prompt: 'Show me all token transfers for address X.' The agent uses `get_address_token_transfers` to build a complete, traceable history of the funds.

### Evaluating Lending Protocol Risk
A DeFi analyst wants to know which pools are most stable. They instruct their agent: 'List supported protocols and summarize lending asset metrics.' The MCP calls `get_defi_lending_protocols_information` and then `get_defi_lending_assets_metrics_summary`, providing a risk overview.

### Deep Market Structure Analysis
A high-frequency trader needs to see immediate changes in liquidity. They ask the agent for 'real-time order book updates.' The MCP calls `get_spot_order_book_events`, giving them delta data far more useful than a static snapshot.

## Benefits

- You instantly get institutional benchmark prices using `get_spot_reference_rates`, eliminating the need to cross-check multiple sources for BTC or ETH value.
- Stop guessing liquidity. Use `get_spot_order_book_snapshots` and `get_spot_order_book_events` to analyze actual market depth, not just last traded prices.
- Model complex risk by comparing derivatives data. Run `get_futures_ohlcv` alongside options metrics from `get_options_tickers` in a single analysis flow.
- Understand the underlying financial plumbing of DeFi. You can list all supported pools using `get_defi_dex_information` and assess lending health with `get_defi_lending_protocols_information`.
- Analyze capital flow from the source. Use `get_address_token_transfers` to map how tokens moved into or out of a specific protocol, giving context to market price changes.

## How It Works

The bottom line is you get complex market insights without ever writing API calls or managing multiple vendor keys.

1. Subscribe to this MCP and enter your Amberdata API Key into the Vinkius catalog.
2. Your agent receives the prompt, identifies the required asset class (e.g., 'spot', 'defi'), and calls the appropriate tool function within the MCP.
3. The MCP processes the data from Amberdata and returns a structured answer to your AI client.

## Frequently Asked Questions

**Can I check asset balances using `get_address_balances_latest`?**
Yes, it retrieves the current native currency balance for a specific blockchain address. This is the starting point for tracking any funds on that network.

**How do I see historical token movement with `get_address_token_transfers`?**
You provide the wallet address, and the tool returns a log of all past ERC-20 token movements. This is critical for forensic analysis.

**What data does `get_spot_vwap_twap` calculate?**
It calculates two key metrics: Volume-Weighted Average Price and Time-Weighted Average Price, giving you a more accurate measure of the asset's true average value over time than simple closing prices.

**Is `get_defi_lending_protocols_information` useful for risk assessment?**
Yes. It lists supported protocols like Aave and Compound, allowing you to determine which lending environments are available for your analysis.

**What data does `get_spot_order_book_snapshots` provide?**
It gives full, 1-minute snapshots of the order book for any spot instrument. This is crucial because it lets you analyze market depth and liquidity at set intervals without relying only on trade ticks.

**Can I use `get_futures_ohlcv` to compare derivatives pricing against spot markets?**
Absolutely. It retrieves aggregated Open, High, Low, Close, and Volume data specifically for futures contracts. This helps you directly contrast how perpetuals are moving versus standard spot prices.

**Are the rates from `get_spot_reference_rates` benchmark-compliant?**
Yes, these benchmark prices adhere to SOC I/II compliance standards. You can trust that you're using recognized industry benchmarks for major assets like BTC and ETH when calculating values.

**How should I approach tracking network health with `get_blocks_metrics_historical`?**
You query this tool to get block-level metrics over time. It's useful for understanding core network performance, like overall throughput or gas usage trends, rather than just following token transfers.

**How do I retrieve the current price and spread for a specific crypto pair?**
Use the `get_spot_tickers` tool for the latest bid/ask data or `get_spot_bid_ask_spread` for detailed liquidity metrics on a specific instrument.

**Can I check the balance of a specific blockchain address?**
Yes, use the `get_address_balances_latest` tool. You will need to provide the address and the corresponding `blockchain_id`.

**Is DeFi lending protocol data available?**
Absolutely. You can query lending protocol information using `get_defi_lending_protocols_information` or get summaries via `get_defi_lending_assets_metrics_summary`.