Bitpin Exchange

by kamyab7

3 stars
420 downloads
Not rated
GitHub

About

Interact with the Bitpin cryptocurrency exchange API to manage wallets, view market data, and execute orders.

Details

Author
kamyab7
GitHub stars
3
Downloads
420
Categories
Cloud Service, Other, Finance
Tags
#crypto, #trading

- Retrieve wallet balances for various cryptocurrencies.
- Get list of all supported trading markets.
- Fetch current ticker prices and market data.
- Place limit, market, stop-limit, and OCO orders.
- Manage orders: list, retrieve by ID, cancel.
- Retrieve completed orders and recent trades.
- Fetch order books for specific markets.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Bitpin Exchange
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install .NET 9 and reference the BitpinClient NuGet package. Configure your Bitpin API Key and Secret either via environment variables (BITPIN_API_KEY, BITPIN_API_SECRET) or in C# settings. Add the MCP server configuration to your application (e.g., in appsettings.json) specifying the dotnet command and the project path. Then run the server using standard MCP client setup.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bitpin exchange": {
            "BitpinExchange": {
                "command": "dotnet",
                "args": [
                    "run",
                    "--project",
                    "{YOUR-PATH}\\MCPServer.csproj",
                    "--no-build"
                ],
                "env": {
                    "BITPIN_API_KEY": "****",
                    "BITPIN_API_SECRET": "****",
                    "BITPIN_API_URL": "https://api.bitpin.org/api/v1/"
                }
            }
        }
    }
}

McpServers

{
    "BitpinExchange": {
        "command": "dotnet",
        "args": [
            "run",
            "--project",
            "{YOUR-PATH}\\MCPServer.csproj",
            "--no-build"
        ],
        "env": {
            "BITPIN_API_KEY": "****",
            "BITPIN_API_SECRET": "****",
            "BITPIN_API_URL": "https://api.bitpin.org/api/v1/"
        }
    }
}

Interact with the Bitpin cryptocurrency exchange API to manage wallets, view market data, and execute orders.

This repository provides an MCP server implementation for the Bitpin cryptocurrency exchange. The server exposes several tools for interacting with the Bitpin API, such as retrieving wallet balances, market data, order details, and executing various types of orders like limit orders, market orders, stop-limit orders, and OCO (One Cancels the Other) orders.

Check out a live demo of the Bitpin MCP Server in action, showcasing LLM-powered crypto trading:

The MCP server provides the following tools:

- GetWalletsListAsync: Retrieve a list of wallet balances for various cryptocurrencies.
- GetMarketsListAsync: Retrieve a list of all supported trading markets.
- GetTickersListAsync: Retrieve the current price list of Bitpin's markets.
- GetCurrenciesAsync: Retrieve a list of supported cryptocurrencies with details such as symbol, name, and tradability status.
- GetOrderbooksAsync: Retrieve the open orders in a specific trading market.
- GetMatchesAsync: Retrieve the latest executed trades for a specific market.
- CreateLimitOrderAsync: Place a limit order to buy or sell a cryptocurrency at a specified price.
- CreateMarketOrderAsync: Place a market order to instantly buy or sell at the best available price.
- CreateStopLimitOrderAsync: Place a stop-limit order to buy or sell once a specific stop price is reached.
- CreateOcoOrderAsync: Place an OCO (One Cancels the Other) order to manage both limit and stop-limit orders simultaneously.
- GetOrdersAsync: Retrieve your list of orders.
- GetCompeletedOrdersAsync: Retrieve details of your completed orders (executed trades).
- GetOrderByIdAsync: Retrieve a specific order by its order ID.
- CancelOrderByIdAsync: Cancel a specific order by its order ID.

- .NET 9 or higher
- TheBitpinClientNuGet package
- Access to the Bitpin API (API Key and Secret)
-

Install Dependencies
Ensure that your project references the requiredBitpinClientpackage and all necessary dependencies for MCP server tools.

Configure Bitpin API Settings
Set up your API Key and Secret for the Bitpin API in theBitpinClientSettings:

var settings = new BitpinClientSettings() { Key = "*", // Replace with your Bitpin API Key Secret = "", // Replace with your Bitpin API Secret };

MCP Server Configuration
Add the MCP server configuration to your application settings:

{ "mcpServers": { "BitpinExchange": { "command": "dotnet", "args": [ "run", "--project", "D:\\projects\\bitpin-mcp-server\\src\\MCPServer\\MCPServer.csproj", "--no-build" ], "env": { "BITPIN_API_KEY": "", "BITPIN_API_SECRET": "", "BITPIN_API_URL": "https://api.bitpin.org/api/v1/" } } } }

Use the following configuration to add theBitpinClientservice and set up the MCP server:

using BitpinClient; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; var builder = Host.CreateEmptyApplicationBuilder(settings: null); var settings = new BitpinClientSettings() { Key = "", // Replace with your API Key Secret = "", // Replace with your API Secret }; builder.Services.AddBitpinClient(settings); builder.Services.AddMcpServer() .WithStdioServerTransport() .WithToolsFromAssembly(); var app = builder.Build(); await app.RunAsync();

The project includes comprehensive unit tests to ensure the reliability of the Bitpin client integration. The tests are organized into several categories:

- MarketData: Tests for retrieving market information, tickers, orderbooks, and currency data
-
Authentication: Tests for token retrieval and refresh functionality
-
UserData: Tests for retrieving user wallet information
-
OrderManagement: Tests for retrieving, canceling, and managing orders
-
OrderCreation: Tests for creating different types of orders (limit, market, stop-limit, OCO)
-
ErrorHandling: Tests for proper handling of error conditions

To run the tests, use the following command:

dotnet test --filter "Category=MarketData"

The tests use a BitpinClientSettings configuration with API keys. For security reasons, these keys are masked in the test code. When running tests locally, replace the placeholder values with your actual API keys.

Note*: Some tests that create real orders on the exchange are marked with[Ignore]to prevent accidental execution. These tests should only be run manually and with caution.

This MCP server provides an easy way to integrate with the Bitpin API and interact with your wallets, orders, and markets. You can place orders, retrieve market data, and manage your assets efficiently using these tools.

Realtime and Historical Exchange Rate Data, FX pairs, bid/ask, OHLC and Crypto prices

Streams real-time Binance Alpha token prices and liquidity data for AI agents and workflows.

Access Alpha Vantage financial data APIs to get real-time and historical stock data, forex rates, and cryptocurrency information.

Provides seamless access to the Binance exchange API. Requires Binance API credentials to be configured.

Interact with the Binance API to view portfolios, convert tokens, and execute trades with minimal market impact.

Access the Binance Futures API for trading, account management, and market data.

Access Bybit's v5 API for real-time market data, trading operations, and account information.

Integrates with the Coincheck cryptocurrency exchange API.

Provides real-time cryptocurrency price data from the OKX exchange.

Landau-Ginzburg market phase transition signals for financial markets. Agent-first MCP with x402 micropayment. Real-time HS300/BTC phase classification (SOLID/LIQUID/CRITICAL), SoTI sensing, daily briefings.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.