x402-data-tools 0.1.0__tar.gz

x402_data_tools-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x402-data-tools contributors
+
+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.

x402_data_tools-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.5
+Name: x402-data-tools
+Version: 0.1.0
+Summary: 180+ pay-per-call data tools for AI agents over x402: token, wallet, company and website reports, crypto, SEC, FRED, weather, web pages. LangChain, CrewAI, OpenAI and Anthropic tool formats.
+Project-URL: Homepage, https://github.com/shadowdomnic/x402-data-tools
+Project-URL: Service, https://bess-x402.onrender.com
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,base,crewai,crypto,langchain,mcp,sec,tools,usdc,x402
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: eth-account>=0.13
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2
+Requires-Dist: x402[evm,httpx]>=2.25
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.80; extra == 'crewai'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3; extra == 'langchain'
+Description-Content-Type: text/markdown
+
+# x402-data-tools
+
+184 data tools for AI agents, each paid per call in USDC on Base over [x402](https://x402.org).
+You don't need an account or an API key, and there is a free tier of 20 calls a day.
+
+```bash
+pip install x402-data-tools              # core client
+pip install "x402-data-tools[langchain]" # + LangChain / LangGraph tools
+pip install "x402-data-tools[crewai]"    # + CrewAI tools
+```
+
+## What's inside
+
+| Kind | Examples | Price |
+|---|---|---|
+| **Reports** (one call, scored verdict) | token due diligence, wallet profile, company financial health, website audit, macro briefing | $0.02-0.05 |
+| Crypto & EVM | token prices, DEX pools, Uniswap price, gas, balances, ERC-20 transfers, token risk, Aave health, funding rates, options | $0.003 |
+| Stocks & macro | SEC fundamentals, filings, insider trades, screener, FRED series, Treasury curve, FX, central-bank rates, Eurostat | $0.003-0.005 |
+| Web | page to Markdown, metadata, DNS, WHOIS, SSL, headers, tech stack, email security | $0.003-0.005 |
+| Everything else | weather, US alerts, VIN decode, FDA drug labels, clinical trials, prediction markets, arXiv, CVEs, calculators | $0.003 |
+
+Call `X402DataTools().catalog` to list all of them, or `search("yield curve")` to find one.
+
+## Quick start
+
+```python
+from x402_data_tools import X402DataTools
+
+tools = X402DataTools()                        # free tier: 20 calls/day per IP
+print(tools.call("macro_briefing")["signals"])
+
+paid = X402DataTools(private_key="0x...")      # or set X402_PRIVATE_KEY; pays per call
+report = paid.call("token_due_diligence_report",
+                   token="0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed", chain="base")
+print(report["grade"], report["verdict"])
+```
+
+For paid calls, use a dedicated wallet that holds a few dollars of USDC on Base. It needs no ETH, because payments are gasless signatures.
+
+## LangChain / LangGraph
+
+```python
+from langgraph.prebuilt import create_react_agent
+from x402_data_tools.langchain import get_tools
+
+agent = create_react_agent(llm, get_tools())             # a default dozen tools
+agent = create_react_agent(llm, get_tools(tags=["report"]))
+```
+
+## CrewAI
+
+```python
+from crewai import Agent
+from x402_data_tools.crewai import get_tools
+
+analyst = Agent(role="Crypto analyst", goal="Vet tokens before we list them",
+                backstory="...", tools=get_tools(["token_due_diligence_report", "wallet_profile_report"]))
+```
+
+## OpenAI / Anthropic function calling
+
+```python
+from x402_data_tools.openai import openai_tools, anthropic_tools, run_tool_call
+
+tools = openai_tools()            # or anthropic_tools()
+# when the model asks for a tool:
+content = run_tool_call(call.function.name, call.function.arguments)
+```
+
+## MCP (Claude, Cursor, etc.)
+
+You don't need this package for MCP. Add the remote server
+`https://bess-x402.onrender.com/mcp`. It gives 20 free calls a day, then answers with the paid x402 URL.
+
+## Notes
+
+- Data comes from public and openly licensed sources: SEC EDGAR, FRED public series, US Treasury, OFAC, NWS, openFDA, DefiLlama, public RPC and others.
+- Reports are automated heuristics. They are not financial, legal or security advice.
+- Errors come back as `X402ToolError`, with `.status` set to 400 for bad input and 5xx when an upstream source is down. `FreeQuotaExceeded` means you should set a key.
+
+MIT licensed.

x402_data_tools-0.1.0/README.md

@@ -0,0 +1,81 @@
+# x402-data-tools
+
+184 data tools for AI agents, each paid per call in USDC on Base over [x402](https://x402.org).
+You don't need an account or an API key, and there is a free tier of 20 calls a day.
+
+```bash
+pip install x402-data-tools              # core client
+pip install "x402-data-tools[langchain]" # + LangChain / LangGraph tools
+pip install "x402-data-tools[crewai]"    # + CrewAI tools
+```
+
+## What's inside
+
+| Kind | Examples | Price |
+|---|---|---|
+| **Reports** (one call, scored verdict) | token due diligence, wallet profile, company financial health, website audit, macro briefing | $0.02-0.05 |
+| Crypto & EVM | token prices, DEX pools, Uniswap price, gas, balances, ERC-20 transfers, token risk, Aave health, funding rates, options | $0.003 |
+| Stocks & macro | SEC fundamentals, filings, insider trades, screener, FRED series, Treasury curve, FX, central-bank rates, Eurostat | $0.003-0.005 |
+| Web | page to Markdown, metadata, DNS, WHOIS, SSL, headers, tech stack, email security | $0.003-0.005 |
+| Everything else | weather, US alerts, VIN decode, FDA drug labels, clinical trials, prediction markets, arXiv, CVEs, calculators | $0.003 |
+
+Call `X402DataTools().catalog` to list all of them, or `search("yield curve")` to find one.
+
+## Quick start
+
+```python
+from x402_data_tools import X402DataTools
+
+tools = X402DataTools()                        # free tier: 20 calls/day per IP
+print(tools.call("macro_briefing")["signals"])
+
+paid = X402DataTools(private_key="0x...")      # or set X402_PRIVATE_KEY; pays per call
+report = paid.call("token_due_diligence_report",
+                   token="0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed", chain="base")
+print(report["grade"], report["verdict"])
+```
+
+For paid calls, use a dedicated wallet that holds a few dollars of USDC on Base. It needs no ETH, because payments are gasless signatures.
+
+## LangChain / LangGraph
+
+```python
+from langgraph.prebuilt import create_react_agent
+from x402_data_tools.langchain import get_tools
+
+agent = create_react_agent(llm, get_tools())             # a default dozen tools
+agent = create_react_agent(llm, get_tools(tags=["report"]))
+```
+
+## CrewAI
+
+```python
+from crewai import Agent
+from x402_data_tools.crewai import get_tools
+
+analyst = Agent(role="Crypto analyst", goal="Vet tokens before we list them",
+                backstory="...", tools=get_tools(["token_due_diligence_report", "wallet_profile_report"]))
+```
+
+## OpenAI / Anthropic function calling
+
+```python
+from x402_data_tools.openai import openai_tools, anthropic_tools, run_tool_call
+
+tools = openai_tools()            # or anthropic_tools()
+# when the model asks for a tool:
+content = run_tool_call(call.function.name, call.function.arguments)
+```
+
+## MCP (Claude, Cursor, etc.)
+
+You don't need this package for MCP. Add the remote server
+`https://bess-x402.onrender.com/mcp`. It gives 20 free calls a day, then answers with the paid x402 URL.
+
+## Notes
+
+- Data comes from public and openly licensed sources: SEC EDGAR, FRED public series, US Treasury, OFAC, NWS, openFDA, DefiLlama, public RPC and others.
+- Reports are automated heuristics. They are not financial, legal or security advice.
+- Errors come back as `X402ToolError`, with `.status` set to 400 for bad input and 5xx when an upstream source is down. `FreeQuotaExceeded` means you should set a key.
+
+MIT licensed.

x402_data_tools-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "x402-data-tools"
+version = "0.1.0"
+description = "180+ pay-per-call data tools for AI agents over x402: token, wallet, company and website reports, crypto, SEC, FRED, weather, web pages. LangChain, CrewAI, OpenAI and Anthropic tool formats."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+keywords = ["x402", "ai-agents", "langchain", "crewai", "tools", "usdc", "base", "crypto", "sec", "mcp"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Intended Audience :: Developers",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = ["httpx>=0.27", "pydantic>=2", "x402[evm,httpx]>=2.25", "eth-account>=0.13"]
+
+[project.optional-dependencies]
+langchain = ["langchain-core>=0.3"]
+crewai = ["crewai>=0.80"]
+
+[project.urls]
+Homepage = "https://github.com/shadowdomnic/x402-data-tools"
+Service = "https://bess-x402.onrender.com"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/x402_data_tools"]

x402_data_tools-0.1.0/src/x402_data_tools/__init__.py

@@ -0,0 +1,10 @@
+"""180+ pay-per-call data tools for AI agents: token, wallet, company and website reports, crypto and EVM data,
+SEC filings, FRED and Treasury macro data, weather, web pages as Markdown and more. Paid per call in USDC on
+Base over x402 (no account or API key), with a free tier of 20 calls a day."""
+
+from .client import (BASE_URL, DEFAULT_TOOLS, FreeQuotaExceeded, ToolSpec, X402DataTools, X402ToolError,
+                     load_catalog)
+
+__all__ = ["BASE_URL", "DEFAULT_TOOLS", "FreeQuotaExceeded", "ToolSpec", "X402DataTools", "X402ToolError",
+           "load_catalog"]
+__version__ = "0.1.0"