Metadata-Version: 2.4
Name: subnetaiq
Version: 1.0.0
Summary: SubnetAIQ Python SDK — Bittensor intelligence for agents and developers
Home-page: https://subnetaiq.io/api/docs
Author: SubnetAIQ
Author-email: jasonddaniel2@gmail.com
Keywords: bittensor,tao,subnet,crypto,ai,agents,api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# SubnetAIQ Python SDK

Bittensor intelligence in one line. Health scores, mineability, risk levels, intel briefs, and more — for all 128 subnets.

## Install

```bash
pip install subnetaiq
```

## Quick Start

```python
from subnetaiq import SubnetAIQ

# No key needed for free tier (1,000 calls/month)
aiq = SubnetAIQ()

# Get health scores for all subnets
health = aiq.health()

# Check a specific subnet
sn18 = aiq.health(netuid=18)
print(f"SN18: {sn18['verdict']} — score {sn18['health_score']}")

# Which subnets are profitable to mine?
mine = aiq.mineability()

# Is the subnet owner draining value?
drain = aiq.owner_drain(netuid=71)
print(f"SN71 owner: {drain['drain_status']}")

# Get today's intel brief with buy/sell signals
intel = aiq.intel()

# Current TAO price
price = aiq.tao_price()
```

## With API Key (higher limits)

```python
# Register for a free key
key = SubnetAIQ.register("you@example.com")
print(f"Your key: {key}")

# Use the key
aiq = SubnetAIQ(api_key=key)

# Check your usage
usage = aiq.usage()
print(f"Used {usage['calls_used']}/{usage['limit']} calls this month")
```

## All Methods

| Method | Description |
|--------|-------------|
| `health(netuid=None)` | 7-factor health scores, verdict, red flags |
| `emission_share(netuid=None)` | % of network emissions per subnet |
| `mineability(netuid=None)` | MINE/CAUTION/AVOID verdicts |
| `risk(netuid=None)` | Dump/dereg risk: LOW/MODERATE/HIGH/CRITICAL |
| `rankings()` | Blended ranking with BUY/SELL/HOLD signals |
| `intel()` | Daily AI-analyzed intelligence brief |
| `live(netuid=None)` | Real-time price, liquidity, emissions |
| `tao_price()` | Current TAO/USD price |
| `validators()` | Validator rankings and take rates |
| `owner_drain(netuid)` | Owner wallet behavior analysis |
| `usage()` | Check your API key usage |
| `register(email)` | Get a free API key |

## Pricing

- **Free**: 1,000 calls/month, 10/min
- **Builder**: $29/mo — 25,000 calls/month
- **Pro**: $99/mo — 100,000 calls/month
- **Enterprise**: $299/mo — 500,000 calls/month

[Full API docs →](https://subnetaiq.io/api/docs)

## Links

- [API Documentation](https://subnetaiq.io/api/docs)
- [MCP Server](https://www.npmjs.com/package/subnetaiq-mcp)
- [SubnetAIQ](https://subnetaiq.io)
