logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

crypto-market-data-aggregator-binance

A Model Context Protocol (MCP) utility providing AI agents with live access to comprehensive cryptocurrency market intelligence sourced directly from the Binance exchange, encompassing pricing streams, order depth structures, historical price bars, and trading statistics.

Author

crypto-market-data-aggregator-binance logo

snjyor

Apache License 2.0

Quick Info

GitHub GitHub Stars 31
NPM Weekly Downloads 0
Tools 1
Last Updated 2026-02-19

Tags

binanceapisrequestsbinance mcpdata binancebinance including

Binance Exchange Data Interface via MCP

smithery badge

Binance Cryptocurrency MCP server

This service implements the Model Context Protocol (MCP) specification to facilitate programmatic retrieval of current and historical cryptocurrency market data originating from the Binance platform.

Service Overview

This MCP interface empowers autonomous AI entities (such as advanced language models or planning systems) to execute targeted Binance Application Programming Interface (API) interactions. The retrieved data set covers essential market metrics, including instantaneous valuations, limit order book granularity, time-series candlestick representations, and volume metrics.

Core Utility The primary function is to furnish agents with immediate access to up-to-the-minute asset valuations, trading throughput metrics, recent volatility trends, and other relevant exchange dynamics, negating the necessity for external web scraping or proprietary tool invocation.

Available Data Streams The service exposes the following categories of market insights:

  • Real-Time Valuations: Fetching the present transactional price for specified digital assets.
  • Depth Information: Inspecting the active limit order book structure (bid/ask spread).
  • Time-Series Bars (Klines): Retrieving OHLCV (Open, High, Low, Close, Volume) data across configurable temporal resolutions.
  • Diurnal Change Metrics: Observing price deviation statistics over a rolling 24-hour period.
  • Transaction Ledger: Accessing a chronological record of completed trades.
  • Statistical Summaries: Retrieving aggregated price performance metrics across various lookback intervals.

Exposed Functionality (Tools)

Function Name Operation Description
get_price Retrieve the contemporary market rate for a designated instrument.
get_order_book Fetch the current depth profile of buy and sell interest.
get_recent_trades List the most recently executed transaction records.
get_historical_trades Acquire a dataset of past trading activities.
get_aggregate_trades Obtain aggregated transaction groupings (e.g., trade blocks).
get_klines Secure K-line (candlestick) data based on symbol and interval.
get_ui_klines Retrieve K-line data pre-formatted for direct user interface rendering.
get_avg_price Determine the volume-weighted average price over a short period.
get_24hr_ticker Report on the normalized price fluctuation statistics for the preceding day.
get_trading_day_ticker Fetch summary statistics pertinent to the current trading session.
get_book_ticker Obtain the best bid and best ask quotes from the order book.
get_rolling_window_ticker Calculate price change statistics over user-defined sliding time frames.

Integration within Cursor IDE

Global Deployment Procedure Execute the service deployment via NPX:

bash npx -y @snjyor/binance-mcp@latest

In the Cursor Integrated Development Environment: 1. Navigate to Cursor Configuration > MCP Management. 2. Select the option to Establish New MCP Endpoint. 3. Populate the configuration fields: - Identifier: binance-data-feed - Endpoint Type: Execution Command - Command String: npx -y @snjyor/binance-mcp@latest

Local Project Configuration Embed the following structure within your project's .cursor/mcp.json file:

{ "mcpServers": { "binance-data-feed": { "command": "npx", "args": [ "-y", "@snjyor/binance-mcp@latest" ] } } }

Operational Readiness Upon successful configuration, the Binance market analysis functions will become implicitly available to the AI reasoning modules: 1. The full list of tools will be enumerated within the MCP settings panel. 2. Agents will automatically invoke these utilities when contextual relevance is detected. 3. Manual invocation via explicit prompting remains an option.

Integration in Other MCP-Compliant Frameworks

Configuration manifest for non-Cursor environments:

{ "mcpServers": { "binance-data-feed": { "command": "npx", "args": [ "-y", "@snjyor/binance-mcp@latest" ] } } }

Illustrative Application Scenarios

Inquiry Regarding BTC Current Valuation

What is the presently quoted market price for Bitcoin (BTC)?

Analysis of ETH 24-Hour Performance

Provide a summary of how the price trajectory for Ethereum has evolved over the preceding day.

Retrieving BNB Candlestick History

Display the daily (D1) K-line data set for Binance Coin (BNB) covering the last five reporting periods.

Development & Maintenance

bash

Dependency Installation

npm install

Compilation Step

npm run build

Local Runtime Validation

npm run start

Server Inspection and Debugging

Debugging can be performed utilizing the official MCP Inspector.

Execute the following sequence in your shell:

bash

First, ensure the production artifacts are built

npm run build

Then, initiate the Inspector session, pointing it at the compiled entry point

npx @modelcontextprotocol/inspector node dist/index.js

Licensing

This software is distributed under the terms of the Apache 2.0 License.

WIKIPEDIA: XMLHttpRequest (XHR) is an API in the form of a JavaScript object whose methods transmit HTTP requests from a web browser to a web server. The methods allow a browser-based application to send requests to the server after page loading is complete, and receive information back. XMLHttpRequest is a component of Ajax programming. Prior to Ajax, hyperlinks and form submissions were the primary mechanisms for interacting with the server, often replacing the current page with another one.

== History == The concept behind XMLHttpRequest was conceived in 2000 by the developers of Microsoft Outlook. The concept was then implemented within the Internet Explorer 5 browser (1999). However, the original syntax did not use the XMLHttpRequest identifier. Instead, the developers used the identifiers ActiveXObject("Msxml2.XMLHTTP") and ActiveXObject("Microsoft.XMLHTTP"). As of Internet Explorer 7 (2006), all browsers support the XMLHttpRequest identifier. The XMLHttpRequest identifier is now the de facto standard in all the major browsers, including Mozilla's Gecko layout engine (2002), Safari 1.2 (2004) and Opera 8.0 (2005).

=== Standards === The World Wide Web Consortium (W3C) published a Working Draft specification for the XMLHttpRequest object on April 5, 2006. On February 25, 2008, the W3C published the Working Draft Level 2 specification. Level 2 added methods to monitor event progress, allow cross-site requests, and handle byte streams. At the end of 2011, the Level 2 specification was absorbed into the original specification. At the end of 2012, the WHATWG took over development and maintains a living document using Web IDL.

== Usage == Generally, sending a request with XMLHttpRequest has several programming steps.

Create an XMLHttpRequest object by calling a constructor: Call the "open" method to specify the request type, identify the relevant resource, and select synchronous or asynchronous operation: For an asynchronous request, set a listener that will be notified when the request's state changes: Initiate the request by calling the "send" method: Respond to state changes in the event listener. If the server sends response data, by default it is captured in the "responseText" property. When the object stops processing the response, it changes to state 4, the "done" state. Aside from these general steps, XMLHttpRequest has many options to control how the request is sent and how the response is processed. Custom header fields can be added to the request to indicate how the server should fulfill it, and data can be uploaded to the server by providing it in the "send" call. The response can be parsed from the JSON format into a readily usable JavaScript object, or processed gradually as it arrives rather than waiting for the entire text. The request can be aborted prematurely or set to fail if not completed in a specified amount of time.

== Cross-domain requests ==

In the early development of the World Wide Web, it was found possible to brea

See Also

`