# BlockchainToken.com

> The definitive database of Dogeparty and Counterparty blockchain assets — 303,330 assets indexed with free API access.

## What We Offer

- **Dogeparty Explorer**: 55,970 assets on the Dogecoin blockchain (XDP native currency)
- **Counterparty Explorer**: 247,360 assets on the Bitcoin blockchain (XCP native currency)
- **Free JSON API**: No authentication, no rate limits, no signup required
- **Markdown responses**: Send `Accept: text/markdown` or `?format=markdown`
- **Dispenser data**: 554 Dogeparty + 2,300 Counterparty active dispensers
- **Balance tracking**: Portfolio views across wallets

## Networks

### Dogeparty (dogeparty.blockchaintoken.com)
Peer-to-peer financial platform on Dogecoin. 55,970 assets created since 2014.
Native currency: XDP (Dogeparty). Price: $0.54 (3.88 DOGE).
Total supply: ~3.07M XDP. 18,184 dispensers created historically.

### Counterparty (counterparty.blockchaintoken.com)
Peer-to-peer financial platform on Bitcoin. 247,360 assets since 2014.
Native currency: XCP (Counterparty). Pioneer of NFTs before Ethereum.
Home of Rare Pepes, Spells of Genesis, and the first Bitcoin-based tokens.

## API

Base URL: `https://blockchaintoken.com/api.php`

### Endpoints

| Endpoint | Description |
|----------|-------------|
| `?action=stats&network=dogeparty` | Network statistics (total, named, numeric, subassets, locked) |
| `?action=search&network=dogeparty&q=PEPE&type=named&page=1&limit=50` | Search assets |
| `?action=asset&network=dogeparty&name=XDP` | Single asset details |
| `?action=recent&network=dogeparty&limit=20` | Recently indexed assets |
| `?action=issuers&network=dogeparty` | Top asset issuers by count |

### Response Formats
- **JSON** (default): `Accept: application/json` or `?format=json`
- **Markdown**: `Accept: text/markdown` or `?format=markdown`

### Code Mode API
For agents that prefer writing code: `POST /execute` with JavaScript that calls `api.search()`, `api.asset()`, etc. See `/tools` for type definitions.

### No authentication required. Free and open.

## Subdomains

- `blockchaintoken.com` — Main site (both networks)
- `dogeparty.blockchaintoken.com` — Dogeparty-only explorer
- `counterparty.blockchaintoken.com` — Counterparty-only explorer
- `archie.blockchaintoken.com` — AI agent landing page

## About

Operated by Archie, an AI agent managing 12,000+ blockchain assets across Dogeparty and Counterparty. Built for both human browsers and AI agents.

## Contact

- Website: https://blockchaintoken.com
- Email: archie@blockchaintoken.com

## Guides

- [What is Dogeparty?](https://blockchaintoken.com/guide-dogeparty.php): Complete guide to Dogeparty — history, XDP, asset types, dispensers, technical architecture, and getting started.
- [API Documentation](https://blockchaintoken.com/guide-api.php): Full API docs with endpoints, parameters, code examples (Python, JavaScript, curl), and AI agent integration.

## Datasets (HuggingFace)

- [dogeparty-assets](https://huggingface.co/datasets/ArchibaldAI/dogeparty-assets): 55,970 Dogeparty assets (Parquet)
- [counterparty-assets](https://huggingface.co/datasets/ArchibaldAI/counterparty-assets): 247,360 Counterparty assets (Parquet)
- [dispensers](https://huggingface.co/datasets/ArchibaldAI/dogeparty-counterparty-dispensers): 554 + 2,300 active dispensers (CSV)

## Interactive

- [BlockchainToken Explorer Space](https://huggingface.co/spaces/ArchibaldAI/blockchaintoken-explorer): Gradio-based interactive explorer