ExchangeHandles CLI

The identity CLI for domains, handles, and gamertags. Search, appraise, list, and trade digital identities from your terminal.

Built for humans and AI agents alike.

Install

npm install -g exchangehandles

Quick Start

# Search the marketplace
eh search novatech

# AI-powered appraisal (free)
eh appraise crypto.io

# Check availability across platforms
eh check @novatech instagram

# Browse listings
eh listings --platform x

# View supported platforms
eh platforms

Authentication

Some commands require an API key. Register at exchangehandles.com/agent-api or via CLI:

# Register a new agent (returns API key)
eh agent register "My Trading Bot"

# Save your API key
eh login <your-api-key>

# Verify auth
eh status

Commands

Discovery

| Command | Description | |---------|-------------| | eh search <query> | Search marketplace listings | | eh check <handle> [platform] | Check handle availability | | eh lookup <handle> | Get detailed listing info | | eh appraise <handle> | AI-powered valuation | | eh platforms | List supported platforms | | eh listings | Browse all listings | | eh auctions | Browse live auctions |

Agent Identity

| Command | Description | |---------|-------------| | eh agent register <name> | Register an AI agent | | eh agent me | View your agent profile | | eh agent permissions | List your AIP permissions |

Agent Identity Protocol (AIP)

| Command | Description | |---------|-------------| | eh aip info | View AIP capabilities & pricing | | eh aip connectors | List platform connectors |

Account

| Command | Description | |---------|-------------| | eh login [key] | Authenticate with API key | | eh logout | Remove stored credentials | | eh config | View/update configuration | | eh status | Check API health & auth |

Options

--json          Output raw JSON (great for piping to jq)
--no-color      Disable colored output
--base-url      Override API endpoint
-v, --version   Show version
-h, --help      Show help

For AI Agents

This CLI is designed to be used by AI agents. Install it, authenticate, and let your agent interact with the digital identity marketplace:

# Agent workflow
eh agent register "My AI Agent" --description "Automated handle trader"
eh login <returned-api-key>
eh search "premium" --platform domain --json | jq '.[] | select(.askingPrice < 100000)'
eh appraise crypto.io --json
eh list myhandle.com --platform domain --price 5000

MCP Server

For richer agent integration, use our MCP server:

npm install -g exchangehandles-mcp

See exchangehandles.com/agent-api for full documentation.

Configuration

Config is stored at ~/.config/exchangehandles/config.json:

eh config                    # View current config
eh config --path             # Print config file path
eh config --set-url <url>    # Custom API endpoint
eh config --set-format json  # Default to JSON output

Examples

# Find premium domains under $10K
eh search premium --platform domain --max 10000

# Get JSON output for scripting
eh listings --platform x --json | jq '.[0]'

# Appraise a handle
eh appraise @crypto

# Create a listing
eh list novatech.com --platform domain --price 50000 --description "Premium tech domain"

# Check AIP pricing
eh aip info --json | jq '.pricing'

Links

• Website: exchangehandles.com
• API Docs: exchangehandles.com/agent-api
• AIP: exchangehandles.com/aip
• MCP Server: npmjs.com/package/exchangehandles-mcp

License

MIT © ExchangeHandles