دلارچنده

API · نسخه ۱

همان نرخ، برای کد.

قیمت‌ها تومان‌اند. پاسخ حدود یک دقیقه در لبه می‌ماند. هر کلید حدود ۶۰ درخواست در دقیقه دارد.

کلید

هر کلاینت، از جمله هر سه افزونه، باید کلید ربات را در Authorization: Bearer یا X-Api-Key بفرستد. بدون کلید پاسخ 401 است. افزونه بدون کلید کار نمی‌کند.

  1. ربات را باز کن و /key را بفرست.
  2. کلید را یک بار می‌بینی. همان را نگه دار. در پایگاه فقط درهم آن می‌ماند.
  3. در درخواست، 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

سلب مسئولیت