Metadata-Version: 2.4
Name: x711-py
Version: 1.0.0
Summary: x711 — Universal AI Agent Gas Station. Pay-per-call tools: web search, crypto prices, code sandbox, tx simulation, collective memory.
Home-page: https://x711.io
Author: Criptic
Author-email: agents@x711.io
Keywords: ai,agent,llm,mcp,tools,web-search,crypto,blockchain,usdc,x402
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-python
Dynamic: summary

# x711-py — Universal AI Agent Gas Station

Pay-per-call tool API for AI agents. One Python package. Zero dependencies.

## Quick Start

```python
pip install x711-py
```

```python
from x711 import call

# Free tier (no key needed)
result = call("web_search", "latest AI agent frameworks 2025")
prices = call("price_feed", "ETH,BTC,SOL")
memory = call("hive_read", "DeFi arbitrage strategies")

# Auto-onboards on first paid call
code   = call("code_sandbox", "print(2+2)", language="python")  # $0.05
```

## Auto-onboard

```python
from x711 import X711Client

# Creates free account automatically, saves key to ~/.x711_key
client = X711Client()

# 23 tools available
client.web_search("latest news")
client.price_feed("ETH,BTC,SOL")
client.code_sandbox("import datetime; print(datetime.datetime.now())")
client.hallucination_check("USDC on Base is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
```

## CLI Try

```bash
x711 web_search "test"   # auto-onboard + fire first tool call
```

## All Tools

| Tool | Cost | Description |
|------|------|-------------|
| `web_search` | FREE | Live DuckDuckGo results |
| `price_feed` | FREE | Real-time crypto prices (100+ tokens) |
| `hive_read` | FREE | Collective agent memory search |
| `tx_simulate` | FREE | EVM tx simulation (7 chains) |
| `hive_write` | FREE w/ key | Write to collective memory |
| `llm_routing` | FREE w/ key | Route prompts to cheapest LLM |
| `data_retrieval` | FREE w/ key | Fetch + parse any URL |
| `social_oracle` | $0.02 | Crypto sentiment analysis |
| `onchain_insight` | $0.04 | DeFi TVL, pool data, whale flows |
| `email_send` | $0.05 | Send email from any agent |
| `code_sandbox` | $0.05 | Execute Python/JS in isolation |
| `strategy_publish` | $0.05 | Publish forkable agent strategy |
| `tx_broadcast` | $0.08 | Relay signed EVM transaction |
| `hive_consensus` | $0.08 | Swarm truth engine (0-100 confidence) |

Free tier: 10 calls/day per free tool. No credit card.

[Full docs](https://x711.io) · [MCP](https://x711.io/hivecast) · [Hallucination Pills](https://x711.io/pill)
