# بیت پین (bitpin)

مشاهده وضعیت  بازارها و انجام معاملات در صرافی رمزارز بیت‌پین

- نوع: سرور MCP
- دسته: بازار مالی و ارز
- منبع: جامعه
- سازنده: محمدحسین زینال زاده (https://linkedin.com/in/mh-zeynal)
- مجوز: MIT
- آخرین بررسی: 2026-10-22
- صفحه: https://mcpfarsi.ir/servers/bitpin/
- مخزن: https://github.com/mh-zeynal/bitpin-mcp-server
- وب‌سایت سرویس: https://docs.bitpin.ir/v1/docs/Introduction/bitpin-api-documentation

## هشدارها

- نیازمند کلید API: برای کار کردن، کلید حساب خودتان در این سرویس لازم است.

## نصب

- اجرا (stdio): `npx -y bitpin-mcp`
- متغیر محیطی `YOUR_BITPIN_API_KEY` (لازم، محرمانه): کلید API اپ بیت‌پین
- متغیر محیطی `YOUR_BITPIN_SECRET_KEY` (لازم، محرمانه): کلید مخفی API؛ به همراه کلید API ایجاد می‌شود

## ابزارها

- `bitpin_get_currencies`: دریافت فهرست کلیه ارزهای پشتیبانی‌شده، نمادها، نام فارسی، وضعیت معامله و دقت اعشار.
- `bitpin_get_markets`: مشاهده تمام جفت‌ارزهای معاملاتی به همراه حداقل حجم سفارش و ارزهای مبدا و مقصد.
- `bitpin_get_networks`: مشاهده شبکه‌های فعال رمزارزها، وضعیت باز/بسته بودن واریز و برداشت و فرمت صحیح آدرس‌ها.
- `bitpin_get_tickers`: دریافت قیمت زنده، نوسان ۲۴ ساعته، بالاترین/پایین‌ترین قیمت و حجم معاملات کل بازار یا یک ارز خاص.
- `bitpin_get_orderbook`: نمایش دفتر سفارشات عمق بازار شامل ۲۰ ردیف برتر مظنه‌های خرید و فروش.
- `bitpin_get_recent_trades`: مشاهده آخرین تراکنش‌های اجرا شده در هر جفت‌ارز به صورت عمومی و زنده.
- `bitpin_get_commissions`: دریافت جدول درصدهای کارمزد میکر (Maker) و تیکر (Taker) حساب کاربر.
- `bitpin_place_order`: ثبت سفارش‌های خرید و فروش در انواع لیمیت (Limit)، مارکت (Market)، استاپ لیمیت (Stop-Limit) و دوطرفه (OCO).
- `bitpin_place_bulk_orders`: ثبت همزمان تا سقف ۱۰ سفارش روی یک بازار در قالب یک درخواست واحد.
- `bitpin_get_orders`: مشاهده و فیلتر سفارش‌های باز و آرشیو ۷ روزه بر اساس جفت‌ارز، جهت، نوع و وضعیت.
- `bitpin_get_order_by_id`: استعلام جزئیات، مانده، حجم پر شده و وضعیت یک سفارش از طریق شناسه آن.
- `bitpin_cancel_order`: کنسل کردن یک سفارش باز و فعال روی بازار.
- `bitpin_cancel_bulk_orders`: ابطال همزمان چندین سفارش باز با ارسال شناسه سفارش‌ها.
- `bitpin_get_fills`: مشاهده گزارش معاملات اجرا شده کاربر به تفکیک قیمت و کارمزد کسر شده.
- `bitpin_get_wallet_balances`: استعلام مانده آزاد و مسدودشده تمام دارایی‌ها در کیف پول بیت‌پین.
- `bitpin_get_account_numbers`: دریافت لیست شماره شباها و کارت‌های تایید‌شده جهت تسویه ریالی.
- `bitpin_get_deposit_address`: ایجاد و دریافت آدرس کیف پول بلاک‌چین برای واریز رمزارز بر روی شبکه دلخواه.
- `bitpin_get_deposit_history`: گزارش واریزهای تومانی و رمزارزی به همراه وضعیت تایید در شبکه.
- `bitpin_get_withdrawal_history`: گزارش تسویه‌های تومانی و خروج رمزارز با جزئیات آدرس مقصد و وضعیت انتقال.
- `bitpin_create_crypto_withdrawal`: ثبت درخواست انتقال رمزارز به کیف پول خارجی با قابلیت ثبت ممو (Memo).
- `bitpin_create_irt_withdrawal`: درخواست تسویه ریالی و واریز تومان به شماره حساب‌های بانکی تاییدشده.
- `bitpin_create_internal_withdrawal`: ارسال آنی و بدون کارمزد رمزارز به دیگر کاربران بیت‌پین از طریق موبایل یا ایمیل.
- `bitpin_verify_withdrawal_otp`: تایید و نهایی‌سازی درخواست برداشت با ارسال کد ۶ رقمی Google Authenticator یا پیامک.
- `bitpin_authenticate`: تبادل خودکار کلیدهای API و Secret جهت ایجاد توکن امن JWT برای نشست کاری.
- `bitpin_refresh_token`: تازه‌سازی و تمدید خودکار توکن دسترسی منقضی‌شده بدون اختلال در درخواست‌ها.

## نمونه سؤال‌ها

- آخرین وضعیت بازار اتریوم و نوسان ۲۴ ساعت گذشته‌ش رو برام تحلیل کن.
- موجودی کیف پول بیت‌پین من چقدره و هر ارز چقدر ارزش تومانی داره؟
- یک سفارش خرید محدود (Limit) به مبلغ ۵۰ تتر روی قیمت ۵۸,۰۰۰ تومان برام ثبت کن.

## توضیحات

### سرور MCP بیت‌پین (BitPin MCP Server)

این سرور با استفاده از پروتکل استاندارد Model Context Protocol (MCP)، دستیارهای هوش مصنوعی (نظیر Claude Desktop، Cursor، Antigravity، Cline و VS Code) را مستقیماً به API صرافی ارز دیجیتال بیت‌پین متصل می‌کند.

##### این ابزار چه کاری انجام می‌دهد؟
- **دسترسی به بازار زنده:** امکان مشاهده قیمت لحظه‌ای رمزارزها، تغییرات ۲۴ ساعته، دفتر سفارشات (Orderbook) و تاریخچه معاملات عمومی بدون نیاز به کلید API.
- **مدیریت معاملات:** ثبت و لغو انواع سفارش‌های خرید و فروش (Limit، Market، Stop-Limit و OCO) و مشاهده وضعیت سفارش‌های باز و انجام‌شده.
- **مدیریت کیف پول:** استعلام موجودی ارزها، تولید آدرس واریز بر روی شبکه‌های مختلف بلاک‌چین، مشاهده حساب‌های بانکی تومانی و تاریخچه واریز و برداشت.
- **پشتیبانی دوطرفه از زبان فارسی:** هوش مصنوعی توضیحات فنی را به زبان انگلیسی پردازش می‌کند، اما شما می‌توانید نام رمزارزها، اعداد و درخواست‌ها را کاملاً به زبان فارسی بنویسید.

---

##### نحوه راه‌اندازی و استفاده

این سرور در مخزن npm ثبت شده و بدون نیاز به دانلود دستی، مستقیماً از طریق `npx` اجرا می‌شود.

###### ۱. پیکربندی در Claude Desktop
فایل تنظیمات `claude_desktop_config.json` را باز کرده و کد زیر را به بخش `mcpServers` اضافه کنید:

```json
{
  "mcpServers": {
    "bitpin": {
      "command": "npx",
      "args": ["-y", "bitpin-mcp"],
      "env": {
        "BITPIN_API_KEY": "کلید_API_شما",
        "BITPIN_SECRET_KEY": "سکرت_کی_شما"
      }
    }
  }
}
```

> **نکته:** برای استفاده از داده‌های عمومی بازار (مانند دریافت قیمت و اوردر بوک)، نیازی به وارد کردن بخش `env` و کلیدهای API نیست.

###### ۲. پیکربندی در Cursor IDE
کد فوق را داخل فایل `.cursor/mcp.json` پروژه یا تنظیمات اصلی نرم‌افزار Cursor قرار دهید.

###### ۳. نکته مهم امنیتی: محدودیت آی‌پی (خطای ۴۰۳)
کلیدهای API صرافی بیت‌پین تنها با آی‌پی‌های ثابت و ثبت‌شده در بخش **مدیریت توکن (Token Manager)** کار می‌کنند. در صورت فراخوانی ابزارهای معامله یا کیف‌پول از آی‌پی تایید‌نشده (مانند فیلترشکن یا اینترنت همراه با آی‌پی متغیر)، صرافی خطای `HTTP 403 Forbidden` برمی‌گرداند.