1 line
15 KiB
JSON
1 line
15 KiB
JSON
{"repo": "allrates-today/allratestoday-deepseek", "files": {"README.md": {"b7ce883412fe55ddb05379184aebeb4977c349e1": {"t": 1785746599.3733618, "n": 3550, "h": "95690b3842fd8f22", "c": "# AllRatesToday × DeepSeek\n\n[](https://allratestoday.com)\n\nEnglish | [简体中文](./README-zh-CN.md)\n\n> Give DeepSeek chat and agents real-time access to currency exchange rates and historical data — via function calling.\n\nDeepSeek's Chat Completions API is OpenAI-compatible, so the same tool-calling mechanism works. This package ships ready-to-use tool schemas and a thin agent wrapper that lets DeepSeek answer questions like:\n\n- *\"What's USD to EUR right now?\"*\n- *\"Convert 1000 GBP to JPY.\"*\n- *\"How has USD/INR moved over the last 30 days?\"*\n- *\"List every supported currency.\"*\n\nPowered by the [AllRatesToday API](https://allratestoday.com) — 160+ currencies, mid-market rates from Reuters/Refinitiv, public endpoints that need no API key.\n\n## Install\n\n```bash\npip install allratestoday-deepseek\n```\n\n## Quick start — one-shot\n\n```bash\nexport DEEPSEEK_API_KEY=sk-... # from platform.deepseek.com/api_keys\nallratestoday-deepseek --ask \"What is 2500 USD in EUR right now?\"\n```\n\n## Quick start — interactive chat\n\n```bash\nallratestoday-deepseek\n# or:\npython examples/chat.py\n```\n\n## Library usage\n\n```python\nfrom allratestoday_deepseek import DeepSeekCurrencyAgent\n\nwith DeepSeekCurrencyAgent() as agent:\n print(agent.ask(\"How many Japanese Yen is 500 Swiss Francs?\"))\n```\n\nNeed finer control? Use the tool schemas directly with the OpenAI SDK pointed at DeepSeek — see `examples/raw_tool_call.py`.\n\n## Tools exposed\n\n| Tool | API key | Description |\n|---|---|---|\n| `get_exchange_rate` | no | Current mid-market rate between two currencies. |\n| `convert_currency` | no | Convert an amount between two currencies at the live rate. |\n| `get_historical_rates` | yes | Rate history over `1d`, `7d`, `30d`, or `1y`. |\n| `list_currencies` | no | All supported currencies with codes, names, symbols. |\n\nPublic tools (`get_exchange_rate`, `convert_currency`, `list_currencies`) work without a key. Set `ALLRATES_API_KEY` for historical data and multi-target queries.\n\n## Environment variables\n\n| Variable | Required? | Purpose |\n|---|---|---|\n| `DEEPSEEK_API_KEY` | yes | Your DeepSeek API key. |\n| `ALLRATES_API_KEY` | no | AllRatesToday API key (for higher limits). Get one at [allratestoday.com/register](https://allratestoday.com/register). |\n| `ALLRATES_BASE_URL` | no | Override the API base URL (default `https://allratestoday.com/api`). |\n\n## How it works\n\n1. You send DeepSeek a question.\n2. The agent calls `chat.completions.create(..., tools=TOOLS)` — DeepSeek receives all 5 tool schemas.\n3. If DeepSeek decides it needs a rate, it emits a `tool_call` (e.g. `get_exchange_rate(source=\"USD\", target=\"EUR\")`).\n4. The agent runs the tool against the AllRatesToday API and passes the JSON result back.\n5. DeepSeek produces a final natural-language answer, citing the live rate.\n\nNo hallucinated rates — the agent never answers without calling the tool first.\n\n## Compatibility\n\n- DeepSeek models that support function calling (`deepseek-chat`, `deepseek-reasoner`).\n- Python 3.9+.\n- Works on Linux, macOS, and Windows.\n\n## Related\n\n- **MCP server**: [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) — for Claude Code, Cursor, and Claude Desktop.\n- **JavaScript SDK**: [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) — raw SDK for any Node.js or browser app.\n- **Docs**: [allratestoday.com/developers](https://allratestoday.com/developers)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n"}, "5d67679d93d49c2e60a8b9c7e3409737643e990d": {"t": 1785766190.7436137, "n": 3568, "h": "bfd1269aa504b575", "c": "# AllRatesToday × DeepSeek\n\n[](https://allratestoday.com)\n\nEnglish | [简体中文](./README-zh-CN.md)\n\n> Give DeepSeek chat and agents real-time access to currency exchange rates and historical data — via function calling.\n\nDeepSeek's Chat Completions API is OpenAI-compatible, so the same tool-calling mechanism works. This package ships ready-to-use tool schemas and a thin agent wrapper that lets DeepSeek answer questions like:\n\n- *\"What's USD to EUR right now?\"*\n- *\"Convert 1000 GBP to JPY.\"*\n- *\"How has USD/INR moved over the last 30 days?\"*\n- *\"List every supported currency.\"*\n\nPowered by the [AllRatesToday API](https://allratestoday.com) — 160+ currencies, mid-market rates from institutional interbank market data, public endpoints that need no API key.\n\n## Install\n\n```bash\npip install allratestoday-deepseek\n```\n\n## Quick start — one-shot\n\n```bash\nexport DEEPSEEK_API_KEY=sk-... # from platform.deepseek.com/api_keys\nallratestoday-deepseek --ask \"What is 2500 USD in EUR right now?\"\n```\n\n## Quick start — interactive chat\n\n```bash\nallratestoday-deepseek\n# or:\npython examples/chat.py\n```\n\n## Library usage\n\n```python\nfrom allratestoday_deepseek import DeepSeekCurrencyAgent\n\nwith DeepSeekCurrencyAgent() as agent:\n print(agent.ask(\"How many Japanese Yen is 500 Swiss Francs?\"))\n```\n\nNeed finer control? Use the tool schemas directly with the OpenAI SDK pointed at DeepSeek — see `examples/raw_tool_call.py`.\n\n## Tools exposed\n\n| Tool | API key | Description |\n|---|---|---|\n| `get_exchange_rate` | no | Current mid-market rate between two currencies. |\n| `convert_currency` | no | Convert an amount between two currencies at the live rate. |\n| `get_historical_rates` | yes | Rate history over `1d`, `7d`, `30d`, or `1y`. |\n| `list_currencies` | no | All supported currencies with codes, names, symbols. |\n\nPublic tools (`get_exchange_rate`, `convert_currency`, `list_currencies`) work without a key. Set `ALLRATES_API_KEY` for historical data and multi-target queries.\n\n## Environment variables\n\n| Variable | Required? | Purpose |\n|---|---|---|\n| `DEEPSEEK_API_KEY` | yes | Your DeepSeek API key. |\n| `ALLRATES_API_KEY` | no | AllRatesToday API key (for higher limits). Get one at [allratestoday.com/register](https://allratestoday.com/register). |\n| `ALLRATES_BASE_URL` | no | Override the API base URL (default `https://allratestoday.com/api`). |\n\n## How it works\n\n1. You send DeepSeek a question.\n2. The agent calls `chat.completions.create(..., tools=TOOLS)` — DeepSeek receives all 5 tool schemas.\n3. If DeepSeek decides it needs a rate, it emits a `tool_call` (e.g. `get_exchange_rate(source=\"USD\", target=\"EUR\")`).\n4. The agent runs the tool against the AllRatesToday API and passes the JSON result back.\n5. DeepSeek produces a final natural-language answer, citing the live rate.\n\nNo hallucinated rates — the agent never answers without calling the tool first.\n\n## Compatibility\n\n- DeepSeek models that support function calling (`deepseek-chat`, `deepseek-reasoner`).\n- Python 3.9+.\n- Works on Linux, macOS, and Windows.\n\n## Related\n\n- **MCP server**: [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) — for Claude Code, Cursor, and Claude Desktop.\n- **JavaScript SDK**: [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) — raw SDK for any Node.js or browser app.\n- **Docs**: [allratestoday.com/developers](https://allratestoday.com/developers)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n"}, "30b652f22b59f58da56280afc7398aa670145f68": {"t": 1785766212.342853, "n": 3411, "h": "15678d3491445003", "c": "# AllRatesToday × DeepSeek\n\n> Give DeepSeek chat and agents real-time access to currency exchange rates, historical data, and financial news — via function calling.\n\nDeepSeek's Chat Completions API is OpenAI-compatible, so the same tool-calling mechanism works. This package ships ready-to-use tool schemas and a thin agent wrapper that lets DeepSeek answer questions like:\n\n- *\"What's USD to EUR right now?\"*\n- *\"Convert 1000 GBP to JPY.\"*\n- *\"How has USD/INR moved over the last 30 days?\"*\n- *\"What's happening in FX markets today?\"*\n\nPowered by the [AllRatesToday API](https://allratestoday.com) — 160+ currencies, mid-market rates from Reuters/Refinitiv, public endpoints that need no API key.\n\n## Install\n\n```bash\npip install allratestoday-deepseek\n```\n\n## Quick start — one-shot\n\n```bash\nexport DEEPSEEK_API_KEY=sk-... # from platform.deepseek.com/api_keys\nallratestoday-deepseek --ask \"What is 2500 USD in EUR right now?\"\n```\n\n## Quick start — interactive chat\n\n```bash\nallratestoday-deepseek\n# or:\npython examples/chat.py\n```\n\n## Library usage\n\n```python\nfrom allratestoday_deepseek import DeepSeekCurrencyAgent\n\nwith DeepSeekCurrencyAgent() as agent:\n print(agent.ask(\"How many Japanese Yen is 500 Swiss Francs?\"))\n```\n\nNeed finer control? Use the tool schemas directly with the OpenAI SDK pointed at DeepSeek — see `examples/raw_tool_call.py`.\n\n## Tools exposed\n\n| Tool | API key | Description |\n|---|---|---|\n| `get_exchange_rate` | no | Current mid-market rate between two currencies. |\n| `convert_currency` | no | Convert an amount between two currencies at the live rate. |\n| `get_historical_rates` | yes | Rate history over `1d`, `7d`, `30d`, or `1y`. |\n| `list_currencies` | no | All supported currencies with codes, names, symbols. |\n\nPublic tools (`get_exchange_rate`, `convert_currency`, `list_currencies`) work without a key. Set `ALLRATES_API_KEY` for historical data and multi-target queries.\n\n## Environment variables\n\n| Variable | Required? | Purpose |\n|---|---|---|\n| `DEEPSEEK_API_KEY` | yes | Your DeepSeek API key. |\n| `ALLRATES_API_KEY` | no | AllRatesToday API key (for higher limits). Get one at [allratestoday.com/register](https://allratestoday.com/register). |\n| `ALLRATES_BASE_URL` | no | Override the API base URL (default `https://allratestoday.com/api`). |\n\n## How it works\n\n1. You send DeepSeek a question.\n2. The agent calls `chat.completions.create(..., tools=TOOLS)` — DeepSeek receives all 5 tool schemas.\n3. If DeepSeek decides it needs a rate, it emits a `tool_call` (e.g. `get_exchange_rate(source=\"USD\", target=\"EUR\")`).\n4. The agent runs the tool against the AllRatesToday API and passes the JSON result back.\n5. DeepSeek produces a final natural-language answer, citing the live rate.\n\nNo hallucinated rates — the agent never answers without calling the tool first.\n\n## Compatibility\n\n- DeepSeek models that support function calling (`deepseek-chat`, `deepseek-reasoner`).\n- Python 3.9+.\n- Works on Linux, macOS, and Windows.\n\n## Related\n\n- **MCP server**: [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) — for Claude Code, Cursor, and Claude Desktop.\n- **JavaScript SDK**: [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) — raw SDK for any Node.js or browser app.\n- **Docs**: [allratestoday.com/developers](https://allratestoday.com/developers)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n"}, "cada0e4cd419dab1b9e3361a015e1f92bcd34419": {"t": 1785766214.0110822, "n": 3434, "h": "3ec7358a1fd64065", "c": "# AllRatesToday × DeepSeek\n\n> Give DeepSeek chat and agents real-time access to currency exchange rates, historical data, and financial news — via function calling.\n\nDeepSeek's Chat Completions API is OpenAI-compatible, so the same tool-calling mechanism works. This package ships ready-to-use tool schemas and a thin agent wrapper that lets DeepSeek answer questions like:\n\n- *\"What's USD to EUR right now?\"*\n- *\"Convert 1000 GBP to JPY.\"*\n- *\"How has USD/INR moved over the last 30 days?\"*\n- *\"What's happening in FX markets today?\"*\n\nPowered by the [AllRatesToday API](https://allratestoday.com) — 160+ currencies, mid-market rates from Reuters/Refinitiv, public endpoints that need no API key.\n\n## Install\n\n```bash\npip install allratestoday-deepseek\n```\n\n## Quick start — one-shot\n\n```bash\nexport DEEPSEEK_API_KEY=sk-... # from platform.deepseek.com/api_keys\nallratestoday-deepseek --ask \"What is 2500 USD in EUR right now?\"\n```\n\n## Quick start — interactive chat\n\n```bash\nallratestoday-deepseek\n# or:\npython examples/chat.py\n```\n\n## Library usage\n\n```python\nfrom allratestoday_deepseek import DeepSeekCurrencyAgent\n\nwith DeepSeekCurrencyAgent() as agent:\n print(agent.ask(\"How many Japanese Yen is 500 Swiss Francs?\"))\n```\n\nNeed finer control? Use the tool schemas directly with the OpenAI SDK pointed at DeepSeek — see `examples/raw_tool_call.py`.\n\n## Tools exposed\n\n| Tool | API key | Description |\n|---|---|---|\n| `get_exchange_rate` | no | Current mid-market rate between two currencies. |\n| `convert_currency` | no | Convert an amount between two currencies at the live rate. |\n| `get_historical_rates` | no | Rate history over `1d`, `7d`, `30d`, or `1y`. |\n| `list_currencies` | no | All supported currencies with codes, names, symbols. |\n| `get_financial_news` | no | Latest FX market news. |\n\nAll tools use AllRatesToday's public endpoints. Set `ALLRATES_API_KEY` only if you want higher rate limits or multi-target lookups.\n\n## Environment variables\n\n| Variable | Required? | Purpose |\n|---|---|---|\n| `DEEPSEEK_API_KEY` | yes | Your DeepSeek API key. |\n| `ALLRATES_API_KEY` | no | AllRatesToday API key (for higher limits). Get one at [allratestoday.com/register](https://allratestoday.com/register). |\n| `ALLRATES_BASE_URL` | no | Override the API base URL (default `https://allratestoday.com/api`). |\n\n## How it works\n\n1. You send DeepSeek a question.\n2. The agent calls `chat.completions.create(..., tools=TOOLS)` — DeepSeek receives all 5 tool schemas.\n3. If DeepSeek decides it needs a rate, it emits a `tool_call` (e.g. `get_exchange_rate(source=\"USD\", target=\"EUR\")`).\n4. The agent runs the tool against the AllRatesToday API and passes the JSON result back.\n5. DeepSeek produces a final natural-language answer, citing the live rate.\n\nNo hallucinated rates — the agent never answers without calling the tool first.\n\n## Compatibility\n\n- DeepSeek models that support function calling (`deepseek-chat`, `deepseek-reasoner`).\n- Python 3.9+.\n- Works on Linux, macOS, and Windows.\n\n## Related\n\n- **MCP server**: [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) — for Claude Code, Cursor, and Claude Desktop.\n- **JavaScript SDK**: [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) — raw SDK for any Node.js or browser app.\n- **Docs**: [allratestoday.com/developers](https://allratestoday.com/developers)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n"}}}} |