API · نسخه ۱
همان نرخ، برای کد.
قیمتها توماناند. پاسخ حدود یک دقیقه در لبه میماند. هر کلید حدود ۶۰ درخواست در دقیقه دارد.
کلید
هر کلاینت، از جمله هر سه افزونه، باید کلید ربات را در Authorization: Bearer یا X-Api-Key بفرستد. بدون کلید پاسخ 401 است. افزونه بدون کلید کار نمیکند.
- ربات را باز کن و /key را بفرست.
- کلید را یک بار میبینی. همان را نگه دار. در پایگاه فقط درهم آن میماند.
- در درخواست، Authorization: Bearer یا X-Api-Key را بگذار.
آدرس
https://api.dollarchande.live
https://api.dollarchande.live
یک نماد
GET /api/v1/symbols/USD
curl -H "Authorization: Bearer KEY" \ https://api.dollarchande.live/api/v1/symbols/USD
مسیرها
GET /api/v1/latest
آخرین قیمت همه نمادها.
GET /api/v1/symbols
فهرست نمادها.
GET /api/v1/symbols/:id
یک نماد. بهجای :id شناسه را بگذار، مثل USD.
GET /api/v1/symbols/:id/ticks
تیکهای ۲۴ ساعت همان نماد.
GET /api/v1/symbols/:id/ohlc
کندل روزانه. پارامتر days بین 1 و 90 میماند. بیرون این بازه همان سقف یا کف است.
GET /api/v1/exchanges
خرید و فروش تتر در صرافیها، به تومان.
GET /chart/{ID}.png
نمودار ۲۴ ساعت. برای ۷ روز ?r=7d را اضافه کن. این مسیر کلید نمیخواهد.
شکل پاسخ
- price
- آخرین قیمت، تومان
- prev_price
- قیمت قبلی، برای دیدن تغییر
- buy
- سوی خرید، تومان
- sell
- سوی فروش، تومان
- unit
- همیشه toman
- updated_at
- زمان یونیکس
واحد در فیلد unit همیشه toman است. این عدد توصیه مالی نیست.
MCP
عاملها همان کلید را به POST /mcp میفرستند. پروتکل Streamable HTTP است و نشست ذخیره نمیشود. ابزارها list_symbols، get_quote، get_latest، get_ticks، get_ohlc و get_exchanges هستند. سقف با API مشترک است.
POST /mcp
curl -H "Authorization: Bearer KEY" -H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize"}' \
https://api.dollarchande.live/mcp