ramzinex-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ramzinex-mcp show me the current BTC price"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A self-hostable Model Context Protocol server for the Ramzinex (رمزینکس) cryptocurrency exchange.
Unofficial integration. This is a community-built MCP server. The "Ramzinex" name and logo belong to their owner. Not affiliated with, endorsed by, or sponsored by Ramzinex. Trading carries risk — use the order tools at your own risk.
What is this?
ramzinex-mcp exposes the Ramzinex exchange API as MCP tools and prompts
so an LLM agent (Claude, etc.) can read markets, inspect an account, and — when
you explicitly allow it — place and cancel orders. It is a small, stateless,
async Python process you run yourself.
It mirrors the structure and quality of the sibling roshan-*-mcp servers:
typed httpx client, pydantic-settings configuration, full test suite, Docker
/ Helm / Kubernetes / Terraform deploy assets, and generated architecture
diagrams.
Related MCP server: Nobitex Market Data MCP Server
Public vs. private — and the trading guardrail
Ramzinex has two API bases, and this server routes each call to the right one automatically:
Surface | Base URL | Auth | Tools |
Public |
| none | market data (pairs, orderbooks, prices, currencies, networks) |
Private |
|
| orders, funds/balances, deposits, withdrawals, addresses, rewards/commissions, API-key access management |
🔐 Auth headers (Postman-accurate)
The live Ramzinex private API requires two non-standard headers — not the usual
Authorization:Authorization2: Bearer <token> x-api-key: <api_key>The header name carrying the token is configurable via
auth_header_name(defaultAuthorization2; set it toAuthorizationfor legacy compatibility), andx-api-keyis sent whenever anapi_keyis configured (send_x_api_keynow defaultstrue). See Authentication.
⚠️ Money-moving & account-control safety
Some actions move real money or change what your API keys can do. They are gated by three separate per-instance flags, all default
false:
enable_tradinggatesramzinex_place_limit_order,ramzinex_place_market_order,ramzinex_cancel_order.
enable_withdrawalsgatesramzinex_submit_withdraw,ramzinex_confirm_withdraw, andramzinex_allocate_address(creating a deposit address is a wallet-write).
account_controlgatesramzinex_edit_general_accessandramzinex_edit_private_access(API-key access management).A master
read_onlyflag forces all three off regardless of their values. When a gate is off the tool returns a structured refusal and never calls the API:{"error": "trading_disabled", "message": "Set enable_trading=true (and read_only=false) on this instance to allow order placement/cancellation."}Read-only tools (market data, viewing balances/orders) are always allowed. Tokens / secrets / api keys are never logged and are redacted from every error message. See Control flags & safety below.
Order lifecycle — placing is gated by
enable_trading:

Withdrawals are separately gated by
enable_withdrawalsand require 2FA confirmation:

Install
pip install -e . # from a checkout
# or, for development:
pip install -e ".[dev]"Requires Python 3.10+.
Quick start
Public market data needs no configuration at all:
python -m ramzinex_mcp # stdio transport (default)To use private (account) tools, authenticate with either a pre-issued bearer
token or an api_key + secret pair (the server exchanges it for a token via
the getToken login flow and re-issues automatically on a 401):
# Option A: pre-issued bearer token
export RAMZINEX_API_TOKEN=your-personal-api-token
# Option B: api_key + secret login flow (api_token wins if both are set)
export RAMZINEX_API_KEY=your-api-key
export RAMZINEX_SECRET=your-api-secret
# x-api-key is sent by default; the token rides in the Authorization2 header.
# export RAMZINEX_SEND_X_API_KEY=false # opt out of the x-api-key header
# export RAMZINEX_AUTH_HEADER_NAME=Authorization # legacy header-name mode
# Opt in to the gated tools (all default false):
export RAMZINEX_ENABLE_TRADING=true # allow placing/cancelling orders
export RAMZINEX_ENABLE_WITHDRAWALS=true # allow withdrawals + address allocation
export RAMZINEX_ACCOUNT_CONTROL=true # allow API-key access management
python -m ramzinex_mcpRun over HTTP for networked clients:
python -m ramzinex_mcp --transport streamable-http --host 0.0.0.0 --port 8000Configuration (multi-account / multi-instance)
Configuration is read from environment variables via pydantic-settings. One
process can front many Ramzinex accounts — each is a named instance with
its own token and trading policy. Every API tool accepts an optional instance
argument; omit it to use the default.
Shorthand (single default instance)
Variable | Default | Description |
| — | Pre-issued bearer token for private endpoints (wins over api_key+secret). |
| — | API key for the |
| — | API secret paired with |
|
| Header that carries the bearer token (set |
|
| Also send |
|
| Public base URL. |
|
| Private base URL. |
|
| API version segment for the exchange paths. |
|
| Allow placing/cancelling orders. |
|
| Allow withdrawals + deposit-address allocation. |
|
| Allow API-key access management (edit general/private access). |
|
| Master switch: forces all three gates off. |
|
| Verify TLS certificates. |
|
| Per-request timeout (seconds). |
|
| Instance used when |
|
|
|
Nested (named instances)
Variable | Description |
| Pre-issued bearer token for instance |
| API key for |
| API secret for |
| Bearer-token header name for |
| Send |
| Trading switch for |
| Withdrawals + address-allocation switch for |
| API-key access-management switch for |
| Master switch (forces all three gates off) for |
| API version for |
| Public base for |
| Private base for |
| TLS verification (default |
| Per-request timeout seconds (default |
| Instance used when |
|
|
Example: a read-only personal account, a trading bot using api_key+secret, and a strictly read-only viewer.
RAMZINEX__INSTANCES__PERSONAL__API_TOKEN=personal-token
RAMZINEX__INSTANCES__PERSONAL__ENABLE_TRADING=false
RAMZINEX__INSTANCES__BOT__API_KEY=bot-key
RAMZINEX__INSTANCES__BOT__SECRET=bot-secret
RAMZINEX__INSTANCES__BOT__ENABLE_TRADING=true
RAMZINEX__INSTANCES__READONLY__API_TOKEN=viewer-token
RAMZINEX__INSTANCES__READONLY__READ_ONLY=true
RAMZINEX__DEFAULT_INSTANCE=personalSee .env.example for a complete, annotated file. Use
list_instances to see what's configured (names, base URLs, api_version,
auth_header_name, has_credentials, auth_method, enable_trading,
enable_withdrawals, account_control, read_only) — it never reveals
credential values.
Authentication: a pre-issued
api_token, orapi_key+secretexchanged for a cached Bearer (refreshed on 401):

Control flags & safety
Three independent gates plus a master switch protect the account. Use the
effective trading_allowed / withdrawals_allowed / account_control_allowed
values from list_instances (they already fold in read_only):
Flag | Default | Gates | Effective when |
|
|
|
|
|
|
|
|
|
|
|
|
|
| forces all three of the above off | — |
When a gate is off, the tool returns
{"error": "trading_disabled" / "withdrawals_disabled" / "account_control_disabled", "message": ...}
and never contacts the API. ramzinex_refresh_deposits is a non-money-moving
refresh and is not gated.
Authentication: api_token vs api_key + secret
Private endpoints require two non-standard headers:
Authorization2: Bearer <token> and x-api-key: <api_key> (the live API
does not use the standard Authorization). The token-carrying header name is
configurable via auth_header_name (default Authorization2; set
Authorization for legacy mode), and x-api-key is sent whenever an api_key
is configured (send_x_api_key defaults true).
api_token— a pre-issued bearer token, sent directly asAuthorization2: Bearer <token>. Simplest; takes precedence if both are set.api_key+secret— the server POSTs them toauth/api_key/getToken, caches the returned token in memory per instance, reuses it, and re-authenticates once on a401. Callramzinex_authenticateto trigger/verify the login explicitly (it never returns the token). Theapi_keydoubles as thex-api-keyheader value. Tokens, secrets, and api keys are never logged or echoed (Authorization2/Authorization/x-api-key/secret/api_keyare all redacted from errors).
The
read_onlymaster switch overrides the trading / withdrawal / account-control gates:

Use with an MCP client
Add it to your client's MCP server config (stdio):
{
"mcpServers": {
"ramzinex": {
"command": "python",
"args": ["-m", "ramzinex_mcp"],
"env": {
"RAMZINEX_API_TOKEN": "your-personal-api-token",
"RAMZINEX_ENABLE_TRADING": "false"
}
}
}
}Tools
All 45 tools (42 service endpoints + 3 meta) accept an optional instance
(except the two local meta tools, list_instances and ramzinex_docs). Private
tools send Authorization2: Bearer <token> + x-api-key: <api_key>.
Market data — public, no auth
Tool | Endpoint |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Auth & access management — private
Tool | Endpoint | Notes |
|
| Runs the api_key+secret login flow; caches the token (never returns it). |
|
| ⚠️ gated by |
|
| ⚠️ gated by |
Orders — private
Tool | Endpoint | Notes |
|
| read-only |
|
| read-only |
|
| ⚠️ gated by |
|
| ⚠️ gated by |
|
| ⚠️ gated by |
|
| read-only |
Funds — private
Tool | Endpoint |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Wallet (deposits / withdrawals / addresses) — private
Tool | Endpoint | Notes |
|
| read-only |
|
| ⚠️ gated by |
|
| read-only |
|
| read-only |
|
| read-only |
|
| refresh (no funds moved) |
|
| read-only |
|
| read-only |
|
| read-only |
|
| ⚠️ gated by |
|
| ⚠️ gated by |
Rewards & commissions — private
Tool | Endpoint | Notes |
|
| read-only; best-effort path (confirm against panel) |
|
| read-only; best-effort path (confirm against panel) |
Meta
Tool | Description |
| Pings the public pairs endpoint and reports reachability. |
| Lists configured instances (base URLs, |
| Offline reference + links to https://ramzinex.com/exchange/apidocs. |
All endpoints at a glance, grouped by category:

API coverage
Every section/endpoint of the official Postman collection maps to a tool. The
source column is postman for items present in the collection text and
best-effort for the three tools whose exact URLs the pasted collection did not
include (rewards, commissions, and deposit-address allocation) — confirm those
against the Ramzinex panel/Postman.
Postman section / endpoint | Method | Path | Tool | Source |
Market — pairs | GET |
|
| postman |
Market — pair | GET |
|
| postman |
Market — orderbook | GET |
|
| postman |
Market — all orderbooks | GET |
|
| postman |
Market — orderbook buys | GET |
|
| postman |
Market — orderbook sells | GET |
|
| postman |
Market — market buy price | GET |
|
| postman |
Market — market sell price | GET |
|
| postman |
Market — prices feed | GET |
|
| postman |
Market — currencies | GET |
|
| postman |
Market — networks | GET |
|
| postman |
Auth — getToken | POST |
|
| postman |
Auth — editGeneralAccess | POST |
|
| postman |
Auth — editPrivateAccess | POST |
|
| postman |
Orders — list | POST |
|
| postman |
Orders — get | GET |
|
| postman |
Orders — limit | POST |
|
| postman |
Orders — market | POST |
|
| postman |
Orders — cancel | POST |
|
| postman |
Orders — turnover | GET |
|
| postman |
Funds — details | GET |
|
| postman |
Funds — currency detail | GET |
|
| postman |
Funds — summaryDesktop | GET |
|
| postman |
Funds — total | GET |
|
| postman |
Funds — available | GET |
|
| postman |
Funds — in_orders | GET |
|
| postman |
Funds — rial equivalent | GET |
|
| postman |
Funds — usdt equivalent | GET |
|
| postman |
Funds — refresh | POST |
|
| postman |
Wallet — addresses | POST |
|
| postman |
Wallet — allocate address | POST |
|
| best-effort |
Wallet — deposits | GET |
|
| postman |
Wallet — currency deposits | GET |
|
| postman |
Wallet — deposit | GET |
|
| postman |
Wallet — refresh deposits | POST |
|
| postman |
Wallet — withdraws | GET |
|
| postman |
Wallet — currency withdraws | GET |
|
| postman |
Wallet — withdraw | GET |
|
| postman |
Wallet — submit withdraw | POST |
|
| postman |
Wallet — confirm withdraw | POST |
|
| postman |
Rewards — rewards | GET |
|
| best-effort |
Rewards — commissions | GET |
|
| best-effort |
Meta — reachability | GET |
|
| local |
Meta — instances | – | (local) |
| local |
Meta — docs | – | (local) |
| local |
⚠ = money-moving or account-control; gated by enable_trading /
enable_withdrawals / account_control (all forced off by read_only).
Prompts
The server also ships MCP prompts — safety-aware workflows your client can
list and run (details in prompts/README.md):
market_overview— pull pairs + an orderbook and summarize the market.check_balances— walk the funds/balance tools to report holdings.place_trade_safely— a careful checklist that verifiesenable_tradingand confirms parameters before placing a REAL order.portfolio_report— combine funds + open orders + turnover.
Skill
A ready-to-use Claude/agent skill lives at
skills/ramzinex/SKILL.md. It describes when and how
to use these tools — market lookup, balance checks, and the safe trading flow —
with example tool sequences.
Architecture
The MCP client talks to one ramzinex-mcp process, which routes public calls to
publicapi.ramzinex.com and authenticated calls (with the Authorization2 +
x-api-key headers) to ramzinex.com.

One process can serve many accounts; the instance argument selects which token
/ trading policy to use.

A typical flow: read the market on the public API, check the enable_trading
gate, then place and confirm an order on the private API.

Regenerate the diagrams with make diagrams (uses the diagrams package +
Graphviz dot and cairosvg).
Self-hosting & scaling
ramzinex-mcp is stateless, so you can run as many replicas as you like behind a
load balancer. One process fronts multiple accounts via
RAMZINEX__INSTANCES__<NAME>__* — no code change. Back off on HTTP 429 if the
exchange rate-limits you. See deploy/ for Docker Compose,
Kubernetes (raw + Kustomize), a Helm chart, and a Terraform module.
Testing
make smoke # no-network smoke test (tools + prompts + descriptions)
make test # full pytest suite (offline; all HTTP mocked with respx)
make lint # ruffLive tests against the real API are skipped unless RAMZINEX_LIVE=1 is set (and,
for private endpoints, RAMZINEX_API_TOKEN):
RAMZINEX_LIVE=1 pytest tests/live -qLicense
MIT. ramzinex-mcp is an unofficial, community-built integration; the
Ramzinex name and logo belong to their owner.
Available Tools
45 toolshealthcheckA
Check that Ramzinex is reachable via a lightweight public endpoint.
Persian purpose: بررسی در دسترس بودن رمزینکس. Calls the public
GET /exchange/api/{ver}/exchange/pairs endpoint (no auth) and reports
whether the API responded. Returns {reachable, pairs_count?} on
success or a structured error otherwise.
Args: instance: Name of the configured Ramzinex instance. Defaults to the configured default instance when omitted (the public bases work without any token).
Inputs: instance. Returns: object
list_instancesA
List the configured Ramzinex instances (no secrets).
Persian purpose: فهرست نمونههای پیکربندیشده. Useful for discovering
which instance values the other tools accept and which ones are set
up for trading, withdrawals, or account control. Credential values
(api_token, api_key, secret) are NEVER returned — only booleans saying
whether they are configured.
Returns:
{default_instance, instances: [{name, public_base_url, private_base_url, api_version, auth_header_name, has_credentials, auth_method, enable_trading, enable_withdrawals, account_control, read_only, trading_allowed, withdrawals_allowed, account_control_allowed, send_x_api_key, verify_ssl}]}.
Inputs: no named parameters. Returns: object
ramzinex_allocate_addressA
Allocate/generate a deposit address for the wallet — WARNING: wallet write.
Persian purpose: تخصیص آدرس به کیف پول کاربر. Requires configured
credentials AND enable_withdrawals=true (and read_only=false) on
the instance; otherwise it returns
{"error": "withdrawals_disabled", ...} without contacting the API
(creating a deposit address is a wallet-write action).
BEST-EFFORT PATH — confirm against the Ramzinex panel/Postman. The pasted
Postman collection did not include the exact URL for this endpoint; this
tool implements POST /exchange/api/{ver}/exchange/users/me/addresses/generate with body
{network_id, currency_id?} as a documented assumption.
Args:
network_id: Numeric id of the network to allocate an address on
(must be > 0; discover via ramzinex_get_networks).
currency_id: Optional numeric currency id the address is for.
instance: Configured instance to use (default when omitted).
Inputs: network_id (required), currency_id, instance. Returns: object
ramzinex_authenticateA
Authenticate an instance and cache its bearer token (no token leaked).
Persian purpose: احراز هویت و دریافت توکن. Runs the api_key + secret
getToken login flow (POST /exchange/api/{ver}/exchange/auth/api_key/getToken) and caches the
resulting bearer token in memory for subsequent private calls. If the
instance is configured with a pre-issued api_token instead, it simply
reports success. The token value is NEVER returned.
Args: instance: Configured instance to authenticate (default when omitted).
Returns:
{authenticated: true, instance, method} on success, where
method is "api_token" or "api_key"; otherwise a
structured error.
Inputs: instance. Returns: object
ramzinex_cancel_orderA
Cancel one of my open orders — WARNING: this changes account state.
Persian purpose: لغو یک سفارش باز. Requires a configured API token AND
enable_trading=true on the instance; otherwise it returns
{"error": "trading_disabled", ...} without contacting the API. Maps
to POST /exchange/api/v1.0/exchange/users/me/orders/{order_id}/cancel.
Args: order_id: Numeric id of the order to cancel. instance: Configured instance to use (default when omitted).
Inputs: order_id (required), instance. Returns: object
ramzinex_confirm_withdrawA
Confirm a pending withdrawal with 2FA codes — WARNING: moves REAL funds.
Persian purpose: تأیید برداشت با کدهای امنیتی (انتقال وجه واقعی).
Requires configured credentials AND enable_withdrawals=true (and
read_only=false); otherwise it returns
{"error": "withdrawals_disabled", ...} without contacting the API.
Maps to POST /exchange/api/{ver}/exchange/users/me/funds/withdraws/{withdraw_id}/verify
with body {code, ga_code}. This finalizes an irreversible
withdrawal.
Args:
withdraw_id: Numeric id of the withdrawal to confirm (from
ramzinex_submit_withdraw).
code: SMS/email verification code (non-empty).
ga_code: Google Authenticator (TOTP) code (non-empty).
instance: Configured instance to use (default when omitted).
Inputs: withdraw_id (required), code (required), ga_code (required), instance. Returns: object
ramzinex_docsA
Return offline documentation about Ramzinex and this server's tools.
Persian purpose: راهنمای رمزینکس و ابزارها. Use this to learn what Ramzinex offers and how each tool maps to the underlying API, without making any network call. Links point to https://ramzinex.com/exchange/apidocs.
Args:
topic: Optional tool name (e.g. ramzinex_get_pairs) to fetch docs
for a single tool. When omitted, returns the service overview
plus the full tool list.
Returns: A dict with service metadata and matching tool documentation.
Inputs: topic. Returns: object
ramzinex_edit_general_accessA
Update the account-wide API-key general access — WARNING: account control.
Persian purpose: ویرایش دسترسی عمومی کلید API. Requires configured
credentials AND account_control=true (and read_only=false) on the
instance; otherwise it returns
{"error": "account_control_disabled", ...} without contacting the API.
Maps to POST /exchange/api/{ver}/exchange/auth/api_key/editGeneralAccess with body
{addressFree, alert}. This changes security-sensitive access settings
for your API keys.
Args: address_free: 0 or 1 — whether withdrawals to any (non-whitelisted) address are allowed. alert: 0 or 1 — whether access-change alerts are enabled. instance: Configured instance to use (default when omitted).
Inputs: address_free (required), alert (required), instance. Returns: object
ramzinex_edit_private_accessA
Update per-key API access permissions — WARNING: account control.
Persian purpose: ویرایش دسترسی اختصاصی یک کلید API. Requires configured
credentials AND account_control=true (and read_only=false) on the
instance; otherwise it returns
{"error": "account_control_disabled", ...} without contacting the API.
Maps to POST /exchange/api/{ver}/exchange/auth/api_key/editPrivateAccess with body
{api_key_id, withdraw, trade, cancel, excel, ipFree, ips}. This changes
what one specific API key may do.
Args: api_key_id: Numeric id of the API key to edit. withdraw: 0 or 1 — allow withdrawals with this key. trade: 0 or 1 — allow placing orders with this key. cancel: 0 or 1 — allow cancelling orders with this key. excel: 0 or 1 — allow Excel/report export with this key. ip_free: 0 or 1 — when 1, the key works from any IP (no IP allowlist). ips: Optional list of allowed IPs (used when ip_free is 0). instance: Configured instance to use (default when omitted).
Inputs: api_key_id (required), withdraw (required), trade (required), cancel (required), +4 more. Returns: object
ramzinex_get_addressesA
Get my wallet addresses for the given networks (read-only).
Persian purpose: آدرسهای کیف پول کاربر برای شبکههای مشخص. Requires
configured credentials. Maps to POST /exchange/api/{ver}/exchange/users/me/addresses with a body of
{"networks": [...]}.
Args:
networks: Non-empty list of network identifiers to fetch addresses
for (discover them with ramzinex_get_networks).
instance: Configured instance to use (default when omitted).
Inputs: networks (required), instance. Returns: object
ramzinex_get_all_orderbooksA
Get the orderbooks for all pairs at once.
Persian purpose: دفتر سفارشهای همه بازارها. Public, no auth. Maps to
GET /exchange/api/{ver}/exchange/orderbooks/buys_sells.
Args: instance: Configured instance whose public base URL to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_available_balanceA
Get the available (free) balance for one currency (read-only).
Persian purpose: موجودی در دسترس کاربر برای یک ارز مشخص. Requires
configured credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/available/currency/{currency_id}.
Args: currency_id: Numeric id of the currency. instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_get_balance_summaryC
Get the account balance summary (read-only).
Persian purpose: خلاصه دارایی کاربر. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/summaryDesktop.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_commissionsA
List commission / fee history (read-only).
Persian purpose: تاریخچه کمیسیونها و کارمزدها. Requires configured credentials.
BEST-EFFORT PATH — confirm against the Ramzinex panel/Postman. The pasted
Postman collection has a rewards/commissions section but did not include
the exact URL; this tool implements GET /exchange/api/{ver}/exchange/users/me/commissions as a documented
assumption.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_currenciesA
List the currencies supported by Ramzinex.
Persian purpose: فهرست ارزهای پشتیبانیشده. Public, no auth. Maps to
GET /exchange/api/{ver}/exchange/currencies.
Args: instance: Configured instance whose public base URL to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_currency_depositsA
List my deposits for one currency, paginated (read-only).
Persian purpose: واریزهای کاربر برای یک ارز مشخص. Requires configured
credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/deposits/currency/{currency_id}
with limit and offset query params.
Args: currency_id: Numeric id of the currency to list deposits for. limit: Max number of deposits to return (1-1000, default 50). offset: Number of deposits to skip for pagination (default 0). instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), limit, offset, instance. Returns: object
ramzinex_get_currency_fundA
Get balance details for one currency (read-only).
Persian purpose: جزئیات دارایی کاربر برای یک ارز مشخص. Requires
configured credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/details/currency/{currency_id}.
Args:
currency_id: Numeric id of the currency (from
ramzinex_get_currencies).
instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_get_currency_withdrawsA
List my withdrawals for one currency (read-only).
Persian purpose: برداشتهای کاربر برای یک ارز مشخص. Requires configured
credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/withdraws/currency/{currency_id}.
Args: currency_id: Numeric id of the currency to list withdrawals for. instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_get_depositA
Get one deposit by id (read-only).
Persian purpose: مشخصات یک واریز مشخص. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/deposits/{deposit_id}.
Args: deposit_id: Numeric id of the deposit to fetch. instance: Configured instance to use (default when omitted).
Inputs: deposit_id (required), instance. Returns: object
ramzinex_get_depositsA
List my deposits, paginated (read-only).
Persian purpose: فهرست واریزهای کاربر. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/deposits with
limit and offset query params.
Args: limit: Max number of deposits to return (1-1000, default 50). offset: Number of deposits to skip for pagination (default 0). instance: Configured instance to use (default when omitted).
Inputs: limit, offset, instance. Returns: object
ramzinex_get_fundsA
Get full balance details for all currencies (read-only).
Persian purpose: جزئیات دارایی کاربر برای همه ارزها. Requires configured
credentials. Maps to
GET /exchange/api/{ver}/exchange/users/me/funds/details.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_in_orders_balanceA
Get the in-orders (locked) balance for one currency (read-only).
Persian purpose: موجودی درگیر در سفارشهای کاربر برای یک ارز. Requires
configured credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/in_orders/currency/{currency_id}.
Args: currency_id: Numeric id of the currency. instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_get_market_buy_priceA
Estimate the price to BUY for a given quote amount.
Persian purpose: برآورد قیمت خرید برای مبلغ مشخص (ارز مظنه). Public, no
auth. Maps to GET /exchange/api/{ver}/exchange/orderbooks/{pair_id}/market_buy_price with
the amount2 (quote-currency) query parameter.
Args: pair_id: Numeric id of the pair. amount2: Amount in the quote currency (e.g. IRR/Toman) to spend buying. Must be greater than zero. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: pair_id (required), amount2 (required), instance. Returns: object
ramzinex_get_market_sell_priceA
Estimate the price to SELL for a given base amount.
Persian purpose: برآورد قیمت فروش برای مقدار مشخص (ارز پایه). Public, no
auth. Maps to GET /exchange/api/{ver}/exchange/orderbooks/{pair_id}/market_sell_price
with the amount (base-currency) query parameter.
Args: pair_id: Numeric id of the pair. amount: Amount in the base currency to sell. Must be greater than zero. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: pair_id (required), amount (required), instance. Returns: object
ramzinex_get_networksA
List deposit/withdraw networks, optionally filtered.
Persian purpose: شبکههای موجود برای واریز و برداشت. Public, no auth.
Maps to GET /exchange/api/{ver}/exchange/networks with optional
currency_id, withdraw, and deposit query filters.
Args: currency_id: Restrict to one currency's networks (numeric id). withdraw: When set, filter to networks that support withdrawals. deposit: When set, filter to networks that support deposits. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: currency_id, withdraw, deposit, instance. Returns: object
ramzinex_get_orderA
Get one of my orders by id (read-only).
Persian purpose: مشخصات یک سفارش مشخص. Requires a configured API token.
Maps to GET /exchange/api/v1.0/exchange/users/me/orders2/{order_id}.
Args: order_id: Numeric id of the order to fetch. instance: Configured instance to use (default when omitted).
Inputs: order_id (required), instance. Returns: object
ramzinex_get_orderbookA
Get the buy/sell orderbook for a single pair.
Persian purpose: دفتر سفارشهای خرید و فروش یک بازار. Public, no auth.
Maps to
GET /exchange/api/{ver}/exchange/orderbooks/{pair_id}/buys_sells.
Args: pair_id: Numeric id of the pair to fetch the orderbook for. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: pair_id (required), instance. Returns: object
ramzinex_get_orderbook_buysA
Get only the BUY side of the orderbook for a pair.
Persian purpose: سمت خرید دفتر سفارشهای یک بازار. Public, no auth. Maps
to GET /exchange/api/{ver}/exchange/orderbooks/{pair_id}/buys.
Args: pair_id: Numeric id of the pair to fetch buy orders for. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: pair_id (required), instance. Returns: object
ramzinex_get_orderbook_sellsA
Get only the SELL side of the orderbook for a pair.
Persian purpose: سمت فروش دفتر سفارشهای یک بازار. Public, no auth. Maps
to GET /exchange/api/{ver}/exchange/orderbooks/{pair_id}/sells.
Args: pair_id: Numeric id of the pair to fetch sell orders for. instance: Configured instance whose public base URL to use (default when omitted).
Inputs: pair_id (required), instance. Returns: object
ramzinex_get_ordersA
List my orders, filterable and paginated (read-only).
Persian purpose: فهرست سفارشهای کاربر. Requires a configured API token.
Maps to POST /exchange/api/v1.0/exchange/users/me/orders2 with a JSON
body of filters.
Args: limit: Max number of orders to return (1-1000, default 200). offset: Number of orders to skip for pagination (default 0). types: Optional list of order-type ids to filter by. pairs: Optional list of pair ids to filter by. currencies: Optional list of currency ids to filter by. states: Optional list of order-state ids to filter by (e.g. open). is_buy: When true, return only buy orders (default false). instance: Configured instance to use (default when omitted).
Inputs: limit, offset, types, pairs, +4 more. Returns: object
ramzinex_get_pairA
Get a single Ramzinex market pair by its numeric id.
Persian purpose: مشخصات یک بازار مشخص. Public, no auth. Maps to
GET /exchange/api/{ver}/exchange/pairs/{pair_id}.
Args:
pair_id: Numeric id of the pair (e.g. 2 for BTC/IRR). Discover ids
with ramzinex_get_pairs.
instance: Configured instance whose public base URL to use (default
when omitted).
Inputs: pair_id (required), instance. Returns: object
ramzinex_get_pairsA
List all Ramzinex market pairs with their 24h financials.
Persian purpose: فهرست همه بازارها و آمار ۲۴ ساعته. Public, no auth.
Maps to GET /exchange/api/{ver}/exchange/pairs. Returns the full set
of tradeable pairs with last price, buy/sell, and 24h volume data.
Args: instance: Configured instance whose public base URL to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_pricesB
Get the simple prices feed for all markets.
Persian purpose: خوراک ساده قیمتها. Public, no auth. Maps to
GET /exchange/api/exchange/prices (note: this path omits the version
segment).
Args: instance: Configured instance whose public base URL to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_rewardsA
List reward / cashback entries (read-only).
Persian purpose: فهرست پاداشها و کشبکها. Requires configured credentials.
BEST-EFFORT PATH — confirm against the Ramzinex panel/Postman. The pasted
Postman collection has a rewards/commissions section but did not include
the exact URL; this tool implements GET /exchange/api/{ver}/exchange/users/me/rewards as a documented
assumption.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_rial_equivalentA
Get the total account value expressed in Iranian Rial (read-only).
Persian purpose: ارزش کل دارایی به ریال. Requires configured
credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/rial_equivalent.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_total_balanceA
Get the total balance for one currency (read-only).
Persian purpose: موجودی کل کاربر برای یک ارز مشخص. Requires configured
credentials. Maps to GET /exchange/api/{ver}/exchange/users/me/funds/total/currency/{currency_id}.
Args:
currency_id: Numeric id of the currency (from
ramzinex_get_currencies).
instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_get_turnoverA
Get my trading turnover over a number of days (read-only).
Persian purpose: گردش معاملاتی کاربر. Requires a configured API token.
Maps to GET /exchange/api/v1.0/exchange/users/me/orders/turnover
with readable=0, days, and pa=1.
Args: days: Look-back window in days (1-3650, default 30). instance: Configured instance to use (default when omitted).
Inputs: days, instance. Returns: object
ramzinex_get_usdt_equivalentA
Get the total account value expressed in USDT (read-only).
Persian purpose: ارزش کل دارایی به تتر. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/usdt_equivalent.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_get_withdrawA
Get one withdrawal by id (read-only).
Persian purpose: مشخصات یک برداشت مشخص. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/withdraws/{withdraw_id}.
Args: withdraw_id: Numeric id of the withdrawal to fetch. instance: Configured instance to use (default when omitted).
Inputs: withdraw_id (required), instance. Returns: object
ramzinex_get_withdrawsA
List my withdrawals, paginated (read-only).
Persian purpose: فهرست برداشتهای کاربر. Requires configured credentials.
Maps to GET /exchange/api/{ver}/exchange/users/me/funds/withdraws with
limit, offset, and optional currency_id query params.
Args: limit: Max number of withdrawals to return (1-1000, default 50). offset: Number of withdrawals to skip for pagination (default 0). currency_id: Optional currency id to filter withdrawals by. instance: Configured instance to use (default when omitted).
Inputs: limit, offset, currency_id, instance. Returns: object
ramzinex_place_limit_orderA
Place a LIMIT order — WARNING: this executes a REAL trade.
Persian purpose: ثبت سفارش محدود (معامله واقعی). Requires a configured
API token AND enable_trading=true on the instance; otherwise it
returns {"error": "trading_disabled", ...} without contacting the
API. Maps to POST /exchange/api/v1.0/exchange/users/me/orders/limit.
This places a buy or sell order at a fixed price using real funds in the selected account. Double-check the pair, side, amount, and price before calling.
Args:
pair_id: Numeric id of the pair to trade.
amount: Order amount in the base currency (must be > 0).
price: Limit price in the quote currency (must be > 0).
type: Order side, buy or sell.
instance: Configured instance to use (default when omitted).
Inputs: pair_id (required), amount (required), price (required), type (required), +1 more. Returns: object
ramzinex_place_market_orderA
Place a MARKET order — WARNING: this executes a REAL trade.
Persian purpose: ثبت سفارش بازار (معامله واقعی). Requires a configured
API token AND enable_trading=true on the instance; otherwise it
returns {"error": "trading_disabled", ...} without contacting the
API. Maps to POST /exchange/api/v1.0/exchange/users/me/orders/market.
A market order fills immediately at the best available price using real funds — the executed price is not guaranteed. Double-check the pair, side, and amount before calling.
Args:
pair_id: Numeric id of the pair to trade.
amount: Order amount in the base currency (must be > 0).
type: Order side, buy or sell.
instance: Configured instance to use (default when omitted).
Inputs: pair_id (required), amount (required), type (required), instance. Returns: object
ramzinex_refresh_depositsA
Ask the backend to refresh deposits for one currency (no money moved).
Persian purpose: بهروزرسانی واریزهای یک ارز. Requires configured
credentials. This re-scans for incoming deposits; it does NOT move
funds. Maps to POST /exchange/api/{ver}/exchange/users/me/funds/deposits/refresh/currency/{currency_id}.
Args: currency_id: Numeric id of the currency to refresh deposits for. instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), instance. Returns: object
ramzinex_refresh_fundsA
Ask the backend to refresh / recompute balances (read-only effect).
Persian purpose: بهروزرسانی داراییها. Requires configured credentials.
This does NOT move funds; it recomputes the cached balances. Maps to
POST /exchange/api/{ver}/exchange/users/me/funds/refresh.
Args: instance: Configured instance to use (default when omitted).
Inputs: instance. Returns: object
ramzinex_submit_withdrawA
Submit a withdrawal request — WARNING: this moves REAL funds.
Persian purpose: ثبت درخواست برداشت (انتقال وجه واقعی). Requires
configured credentials AND enable_withdrawals=true (and
read_only=false) on the instance; otherwise it returns
{"error": "withdrawals_disabled", ...} without contacting the API.
Maps to POST /exchange/api/{ver}/exchange/users/me/funds/withdraws/currency/{currency_id}
with body {amount, address, network_id, tag?, no_tag}. no_tag is
derived automatically (true when no tag is provided).
Double-check the currency, network, address, and amount before calling — withdrawals are irreversible.
Args:
currency_id: Numeric id of the currency to withdraw.
amount: Amount to withdraw (must be > 0).
address: Destination wallet address (non-empty).
network_id: Numeric id of the withdrawal network (must be > 0;
discover via ramzinex_get_networks).
tag: Optional memo/tag/destination tag for networks that require it
(e.g. XRP, TON). Omit for networks that do not.
instance: Configured instance to use (default when omitted).
Inputs: currency_id (required), amount (required), address (required), network_id (required), +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 45 tools
Every tool has a clearly distinct purpose, targeting different resources or actions. Even similar verbs like 'get_deposits' vs 'get_currency_deposits' vs 'get_deposit' are differentiated by scope and granularity. No two tools overlap in functionality.
All tools follow the 'ramzinex_[verb]_[noun(s)]' pattern with consistent snake_case. Verbs are uniformly lowercase and descriptive (get, list, place, cancel, submit, confirm, edit, allocate). No mixing of conventions or inconsistent naming styles.
45 tools is high but justified given the comprehensive exchange API surface. The count slightly exceeds the typical 'well-scoped' range, yet each tool corresponds to a meaningful endpoint. A few get tools could potentially be merged, but overall the count is reasonable for a full-featured exchange MCP.
The tool set covers the full lifecycle: public market data, account balances (summary, individual, locked), deposits and withdrawals (list, get, refresh, submit, confirm), orders (list, get, place limit/market, cancel), API key management, and account control. No obvious gaps for core trading and wallet operations.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Open-source MCP server for Zerodha Kite Connect. Portfolio, market data, backtesting, alerts.
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Related MCP Servers
- AlicenseBqualityDmaintenanceHigh-performance CCXT MCP server for cryptocurrency exchange integration2494 npm145MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides access to cryptocurrency market data from the Nobitex API, enabling users to fetch specific cryptocurrency pair statistics and global market data.23-

cdcxofficial
AlicenseNot gradedqualityCmaintenanceMCP server for the Crypto.com Exchange API, providing 86 dynamically generated tools for market data, trading, account management, and more with real-time WebSocket streaming and safety enforcement.48 npm27Apache 2.0- FlicenseNot gradedqualityDmaintenancePython-based MCP server that provides real-time and historical cryptocurrency data from 100+ exchanges via CCXT, with tools for tickers, OHLCV, markets, and order books.1-