langchain-dexpaprika 0.1.0__tar.gz

langchain_dexpaprika-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install
+        run: uv sync --extra test
+      - name: Ruff lint
+        run: uv run ruff check .
+      - name: Ruff format
+        run: uv run ruff format --check .
+      - name: Mypy
+        run: uv run mypy src/
+
+  unit:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.12", "3.14"]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install
+        run: uv sync --extra test
+      - name: Unit tests (sockets blocked)
+        run: uv run pytest --disable-socket --allow-unix-socket tests/unit_tests/
+
+  integration:
+    # Live keyless API, roughly 20 requests per run. One serial job so we stay
+    # inside the API's burst limit of about 30 requests per 20 seconds. Skipped
+    # for fork pull requests so untrusted code cannot rewrite the tests to hammer
+    # the live API from our runners.
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    needs: [lint, unit]
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install
+        run: uv sync --extra test
+      - name: Integration tests (live API)
+        run: uv run pytest tests/integration_tests/

langchain_dexpaprika-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,62 @@
+# Publishes to PyPI via trusted publishing (OIDC, no tokens).
+#
+# The PyPI pending publisher for langchain-dexpaprika is bound to exactly:
+#   repository:  coinpaprika/langchain-dexpaprika
+#   workflow:    release.yml
+#   environment: pypi
+# Do not rename this file or the environment; either change breaks the binding.
+#
+# The `pypi` environment must carry required-reviewer protection in the repo
+# settings so a workflow_dispatch cannot publish without a second approval.
+#
+# Release flow: merge to main, create a GitHub release with tag vX.Y.Z,
+# this workflow runs checks, builds with uv, and publishes dist/ to PyPI.
+# Actions are pinned to full commit SHAs (mutable tags are a supply-chain risk
+# for a job that holds id-token: write).
+
+name: release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install
+        run: uv sync --extra test
+      - name: Ruff lint
+        run: uv run ruff check .
+      - name: Ruff format
+        run: uv run ruff format --check .
+      - name: Mypy
+        run: uv run mypy src/
+      - name: Unit tests (sockets blocked)
+        run: uv run pytest --disable-socket --allow-unix-socket tests/unit_tests/
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: [checks]
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
+        with:
+          python-version: "3.12"
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Publish to PyPI (trusted publishing)
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # v1.14.1

langchain_dexpaprika-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Environments
+.venv*/
+venv/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Editors
+.idea/
+.vscode/
+.DS_Store

langchain_dexpaprika-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CoinPaprika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langchain_dexpaprika-0.1.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: all lint format test integration_tests
+
+all: lint test
+
+lint:
+	uv run ruff check .
+	uv run ruff format --check .
+	uv run mypy src/
+
+format:
+	uv run ruff format .
+	uv run ruff check --fix .
+
+test:
+	uv run pytest --disable-socket --allow-unix-socket tests/unit_tests/
+
+integration_tests:
+	uv run pytest tests/integration_tests/

langchain_dexpaprika-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: langchain-dexpaprika
+Version: 0.1.0
+Summary: LangChain tools for the DexPaprika API: keyless DEX market data across every supported blockchain
+Project-URL: Homepage, https://github.com/coinpaprika/langchain-dexpaprika
+Project-URL: Repository, https://github.com/coinpaprika/langchain-dexpaprika
+Project-URL: Documentation, https://docs.dexpaprika.com
+Project-URL: Changelog, https://github.com/coinpaprika/langchain-dexpaprika/releases
+Author: CoinPaprika
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,blockchain,coinpaprika,crypto,defi,dex,dexpaprika,langchain,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Provides-Extra: test
+Requires-Dist: langchain-tests~=1.1; extra == 'test'
+Requires-Dist: mypy>=1.15; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.26; extra == 'test'
+Requires-Dist: pytest-mock>=3.14; extra == 'test'
+Requires-Dist: pytest-socket>=0.7; extra == 'test'
+Requires-Dist: pytest>=8; extra == 'test'
+Requires-Dist: ruff>=0.11; extra == 'test'
+Description-Content-Type: text/markdown
+
+# langchain-dexpaprika
+
+[![PyPI version](https://img.shields.io/pypi/v/langchain-dexpaprika)](https://pypi.org/project/langchain-dexpaprika/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+DexPaprika tools for LangChain agents. No API key, no signup: the
+[DexPaprika API](https://docs.dexpaprika.com) is keyless, so your agent gets
+DEX market data across every supported blockchain (33M+ tokens, 36M+ pools)
+as soon as you install the package.
+
+We built these tools for LLM consumption: descriptions tell the model exactly
+which parameters exist and where to get their values, error messages quote the
+API's own allowed-value lists so the model can self-correct, and outputs are
+compact JSON with multi-kilobyte token descriptions trimmed.
+
+## Installation
+
+```bash
+pip install -U langchain-dexpaprika
+```
+
+No credentials to configure. There is no environment variable to set because
+there is no API key.
+
+## Quickstart
+
+```python
+from langchain_dexpaprika import DexPaprikaSearch
+
+search = DexPaprikaSearch()
+print(search.invoke({"query": "WETH"}))
+```
+
+This returns compact JSON with matching tokens (contract address, chain, USD
+price, liquidity), pools, and DEXes.
+
+## Tools
+
+| Tool name | Class | What it returns |
+| --- | --- | --- |
+| `dexpaprika_search` | `DexPaprikaSearch` | Tokens, pools, and DEXes matching a name, symbol, or address. The entry point when you only have a ticker. |
+| `dexpaprika_token_details` | `DexPaprikaTokenDetails` | Price, FDV, liquidity, pool count, and 24h/6h/1h volume with buy/sell breakdown for one token on one network. |
+| `dexpaprika_token_pools` | `DexPaprikaTokenPools` | Pools where a token trades, sortable by volume, liquidity, transactions, age, price, or 24h price change. |
+| `dexpaprika_pool_ohlcv` | `DexPaprikaPoolOHLCV` | Historical OHLCV candles for one pool, intervals from 1m to 24h, up to 366 candles per call. |
+| `dexpaprika_networks` | `DexPaprikaNetworks` | Every supported network with its exact id, 24h volume, transactions, and pool counts. |
+
+## Use the toolkit in an agent
+
+`DexPaprikaToolkit` bundles all five tools over one shared HTTP client. The
+example below drives them with an Anthropic model, so install the provider and
+set its key first (swap in any chat model you prefer):
+
+```bash
+pip install -U "langchain[anthropic]"
+export ANTHROPIC_API_KEY=...
+```
+
+```python
+from langchain.agents import create_agent
+from langchain_dexpaprika import DexPaprikaToolkit
+
+toolkit = DexPaprikaToolkit()
+agent = create_agent("claude-sonnet-4-5", toolkit.get_tools())
+result = agent.invoke(
+    {"messages": [("user", "Find the most liquid WETH pool on ethereum")]}
+)
+```
+
+The tool descriptions chain naturally: an agent starts with
+`dexpaprika_search` to resolve a ticker into a contract address and network
+id, then feeds those into the other tools.
+
+## Individual tools
+
+Every tool works standalone, sync and async:
+
+```python
+from langchain_dexpaprika import DexPaprikaPoolOHLCV
+
+ohlcv = DexPaprikaPoolOHLCV()
+candles = ohlcv.invoke(
+    {
+        "network": "ethereum",
+        "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
+        "start": "2026-07-10",
+        "interval": "24h",
+        "limit": 7,
+    }
+)
+```
+
+## Error handling
+
+We surface API errors as messages the agent can act on:
+
+- 400 responses quote the API's message verbatim, including the exact list of
+  allowed values for the offending parameter.
+- 404 responses arrive with an empty body, so we synthesize a message that
+  names the missing identifier and points at the tool that lists valid values.
+- 429 responses are retried automatically, honoring the `Retry-After` header,
+  before we tell the agent to slow down.
+- 410 responses (removed endpoints) surface the replacement endpoint the API
+  reports, with a hint to upgrade the package.
+
+## Development
+
+```bash
+uv venv
+uv pip install -e '.[test]'
+make lint                # ruff + mypy
+make test                # unit tests, sockets blocked
+make integration_tests   # live API, keyless, run serially
+```
+
+## Links
+
+- [DexPaprika API documentation](https://docs.dexpaprika.com)
+- [DexPaprika agent integration guide](https://agents.dexpaprika.com)
+- [API reference](https://docs.dexpaprika.com/api-reference/introduction)
+
+## License
+
+MIT

langchain_dexpaprika-0.1.0/README.md

@@ -0,0 +1,123 @@
+# langchain-dexpaprika
+
+[![PyPI version](https://img.shields.io/pypi/v/langchain-dexpaprika)](https://pypi.org/project/langchain-dexpaprika/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+DexPaprika tools for LangChain agents. No API key, no signup: the
+[DexPaprika API](https://docs.dexpaprika.com) is keyless, so your agent gets
+DEX market data across every supported blockchain (33M+ tokens, 36M+ pools)
+as soon as you install the package.
+
+We built these tools for LLM consumption: descriptions tell the model exactly
+which parameters exist and where to get their values, error messages quote the
+API's own allowed-value lists so the model can self-correct, and outputs are
+compact JSON with multi-kilobyte token descriptions trimmed.
+
+## Installation
+
+```bash
+pip install -U langchain-dexpaprika
+```
+
+No credentials to configure. There is no environment variable to set because
+there is no API key.
+
+## Quickstart
+
+```python
+from langchain_dexpaprika import DexPaprikaSearch
+
+search = DexPaprikaSearch()
+print(search.invoke({"query": "WETH"}))
+```
+
+This returns compact JSON with matching tokens (contract address, chain, USD
+price, liquidity), pools, and DEXes.
+
+## Tools
+
+| Tool name | Class | What it returns |
+| --- | --- | --- |
+| `dexpaprika_search` | `DexPaprikaSearch` | Tokens, pools, and DEXes matching a name, symbol, or address. The entry point when you only have a ticker. |
+| `dexpaprika_token_details` | `DexPaprikaTokenDetails` | Price, FDV, liquidity, pool count, and 24h/6h/1h volume with buy/sell breakdown for one token on one network. |
+| `dexpaprika_token_pools` | `DexPaprikaTokenPools` | Pools where a token trades, sortable by volume, liquidity, transactions, age, price, or 24h price change. |
+| `dexpaprika_pool_ohlcv` | `DexPaprikaPoolOHLCV` | Historical OHLCV candles for one pool, intervals from 1m to 24h, up to 366 candles per call. |
+| `dexpaprika_networks` | `DexPaprikaNetworks` | Every supported network with its exact id, 24h volume, transactions, and pool counts. |
+
+## Use the toolkit in an agent
+
+`DexPaprikaToolkit` bundles all five tools over one shared HTTP client. The
+example below drives them with an Anthropic model, so install the provider and
+set its key first (swap in any chat model you prefer):
+
+```bash
+pip install -U "langchain[anthropic]"
+export ANTHROPIC_API_KEY=...
+```
+
+```python
+from langchain.agents import create_agent
+from langchain_dexpaprika import DexPaprikaToolkit
+
+toolkit = DexPaprikaToolkit()
+agent = create_agent("claude-sonnet-4-5", toolkit.get_tools())
+result = agent.invoke(
+    {"messages": [("user", "Find the most liquid WETH pool on ethereum")]}
+)
+```
+
+The tool descriptions chain naturally: an agent starts with
+`dexpaprika_search` to resolve a ticker into a contract address and network
+id, then feeds those into the other tools.
+
+## Individual tools
+
+Every tool works standalone, sync and async:
+
+```python
+from langchain_dexpaprika import DexPaprikaPoolOHLCV
+
+ohlcv = DexPaprikaPoolOHLCV()
+candles = ohlcv.invoke(
+    {
+        "network": "ethereum",
+        "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
+        "start": "2026-07-10",
+        "interval": "24h",
+        "limit": 7,
+    }
+)
+```
+
+## Error handling
+
+We surface API errors as messages the agent can act on:
+
+- 400 responses quote the API's message verbatim, including the exact list of
+  allowed values for the offending parameter.
+- 404 responses arrive with an empty body, so we synthesize a message that
+  names the missing identifier and points at the tool that lists valid values.
+- 429 responses are retried automatically, honoring the `Retry-After` header,
+  before we tell the agent to slow down.
+- 410 responses (removed endpoints) surface the replacement endpoint the API
+  reports, with a hint to upgrade the package.
+
+## Development
+
+```bash
+uv venv
+uv pip install -e '.[test]'
+make lint                # ruff + mypy
+make test                # unit tests, sockets blocked
+make integration_tests   # live API, keyless, run serially
+```
+
+## Links
+
+- [DexPaprika API documentation](https://docs.dexpaprika.com)
+- [DexPaprika agent integration guide](https://agents.dexpaprika.com)
+- [API reference](https://docs.dexpaprika.com/api-reference/introduction)
+
+## License
+
+MIT

langchain_dexpaprika-0.1.0/llms.txt

@@ -0,0 +1,25 @@
+# langchain-dexpaprika
+
+> LangChain tools for the DexPaprika API: keyless DEX market data across every supported blockchain (33M+ tokens, 36M+ pools). No API key, no signup, no credential handling.
+
+## Package
+
+- PyPI: langchain-dexpaprika
+- Import: langchain_dexpaprika
+- Install: pip install -U langchain-dexpaprika
+- Requires: Python >=3.10, langchain-core >=1.0
+
+## Tools
+
+- dexpaprika_search (DexPaprikaSearch): free-text search for tokens, pools, and DEXes; returns contract addresses and network ids for the other tools
+- dexpaprika_token_details (DexPaprikaTokenDetails): price, FDV, liquidity, pool count, and 24h/6h/1h volume for one token on one network
+- dexpaprika_token_pools (DexPaprikaTokenPools): pools where a token trades, sortable by volume, liquidity, transactions, age, or price change
+- dexpaprika_pool_ohlcv (DexPaprikaPoolOHLCV): historical OHLCV candles for one pool, intervals 1m to 24h, up to 366 candles
+- dexpaprika_networks (DexPaprikaNetworks): all supported networks with their exact ids and activity stats
+- DexPaprikaToolkit: all five tools over one shared HTTP client
+
+## Links
+
+- API docs: https://docs.dexpaprika.com
+- Agent integration guide: https://agents.dexpaprika.com
+- Repository: https://github.com/coinpaprika/langchain-dexpaprika

langchain_dexpaprika-0.1.0/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "langchain-dexpaprika"
+version = "0.1.0"
+description = "LangChain tools for the DexPaprika API: keyless DEX market data across every supported blockchain"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10,<4.0"
+authors = [{ name = "CoinPaprika" }]
+keywords = [
+  "langchain",
+  "dexpaprika",
+  "coinpaprika",
+  "dex",
+  "defi",
+  "crypto",
+  "blockchain",
+  "agents",
+  "tools",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "langchain-core>=1.0.0,<2.0.0",
+  "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/coinpaprika/langchain-dexpaprika"
+Repository = "https://github.com/coinpaprika/langchain-dexpaprika"
+Documentation = "https://docs.dexpaprika.com"
+Changelog = "https://github.com/coinpaprika/langchain-dexpaprika/releases"
+
+[project.optional-dependencies]
+test = [
+  "langchain-tests~=1.1",
+  "pytest>=8",
+  "pytest-asyncio>=0.26",
+  "pytest-socket>=0.7",
+  "pytest-mock>=3.14",
+  "mypy>=1.15",
+  "ruff>=0.11",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/langchain_dexpaprika"]
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config --durations=5"
+# asyncio_mode = "auto" is required: langchain-tests async cases get skipped without it.
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.mypy]
+strict = true

langchain_dexpaprika-0.1.0/src/langchain_dexpaprika/__init__.py

@@ -0,0 +1,32 @@
+"""LangChain tools for the DexPaprika API.
+
+Keyless DEX market data across every network DexPaprika covers: 33M+ tokens,
+36M+ pools. No API key, no signup. See https://docs.dexpaprika.com for API
+documentation and https://agents.dexpaprika.com for the agent integration guide.
+"""
+
+from importlib import metadata
+
+from langchain_dexpaprika._client import DexPaprikaAPIWrapper
+from langchain_dexpaprika.networks import DexPaprikaNetworks
+from langchain_dexpaprika.pool_ohlcv import DexPaprikaPoolOHLCV
+from langchain_dexpaprika.search import DexPaprikaSearch
+from langchain_dexpaprika.token_details import DexPaprikaTokenDetails
+from langchain_dexpaprika.token_pools import DexPaprikaTokenPools
+from langchain_dexpaprika.toolkit import DexPaprikaToolkit
+
+try:
+    __version__ = metadata.version("langchain-dexpaprika")
+except metadata.PackageNotFoundError:  # pragma: no cover - only during development
+    __version__ = "0.0.0"
+
+__all__ = [
+    "DexPaprikaAPIWrapper",
+    "DexPaprikaNetworks",
+    "DexPaprikaPoolOHLCV",
+    "DexPaprikaSearch",
+    "DexPaprikaTokenDetails",
+    "DexPaprikaTokenPools",
+    "DexPaprikaToolkit",
+    "__version__",
+]