Tax compliance for AI agent transactions — sales tax, capital gains, nexus monitoring, 1099 tracking.
Tax compliance tools for AI agent transactions. Use when the user or agent needs to:
API docs: https://agenttax.io/api/v1/agents
All requests use the header: X-API-Key: $AGENTTAX_API_KEY
Get a free API key (100 calls/month):
curl -s -X POST https://agenttax.io/api/v1/auth/signup \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "password": "securepass", "agent_name": "my-agent"}'
Save the api_key.key from the response — it is only shown once.
Use when an AI agent buys or sells services, compute, API access, SaaS, or digital goods.
curl -s -X POST https://agenttax.io/api/v1/calculate \
-H "X-API-Key: $AGENTTAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"role": "ROLE",
"amount": AMOUNT,
"buyer_state": "STATE",
"buyer_zip": "ZIP",
"transaction_type": "TYPE",
"work_type": "WORK_TYPE",
"counterparty_id": "COUNTERPARTY",
"is_b2b": IS_B2B
}'
Required fields:
role: "buyer" or "seller"amount: transaction amount in USDbuyer_state: 2-letter US state codetransaction_type: one of compute, api_access, data_purchase, saas, ai_labor, storage, digital_good, consulting, data_processing, cloud_infrastructure, ai_model_access, marketplace_fee, subscription, license, servicecounterparty_id: identifier for the other partyOptional fields:
buyer_zip: 5-digit zip for local rate lookup (recommended — adds city/county tax)work_type: compute, research, content, consulting, trading (drives per-state classification)is_b2b: true/false (affects rates in MD, IA)seller_remitting: true/false (whether seller is collecting tax)Response includes: total_tax, combined_rate, jurisdiction, audit_trail, confidence, advisories.
Sellers: you must configure nexus first (see below) or all calculations return $0.
Use when an agent buys or sells assets (compute tokens, crypto, etc.).
# Buy
curl -s -X POST https://agenttax.io/api/v1/trades \
-H "X-API-Key: $AGENTTAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asset_symbol": "SYMBOL",
"trade_type": "buy",
"quantity": QTY,
"price_per_unit": PRICE
}'
# Sell (returns realized gain/loss)
curl -s -X POST https://agenttax.io/api/v1/trades \
-H "X-API-Key: $AGENTTAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asset_symbol": "SYMBOL",
"trade_type": "sell",
"quantity": QTY,
"price_per_unit": PRICE,
"accounting_method": "fifo",
"resident_state": "STATE"
}'
Cost basis methods: fifo (default), lifo, specific_id.
# All 51 jurisdictions
curl -s https://agenttax.io/api/v1/rates
# Single state with explanation
curl -s "https://agenttax.io/api/v1/rates?state=TX&explain=true"
Sellers must set nexus states to get non-zero tax results.
curl -s -X POST https://agenttax.io/api/v1/nexus \
-H "X-API-Key: $AGENTTAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"nexus": {
"TX": { "hasNexus": true, "reason": "Economic nexus" },
"NY": { "hasNexus": true, "reason": "Physical presence" }
}
}'
curl -s https://agenttax.io/api/v1/health
All errors return { "success": false, "error": "message", "agent_guide": "https://agenttax.io/api/v1/agents" }.
error and errors fields