# Spectrum Data Digital - Instructions for Large Language Models
# https://spectrumdatadigital.org
# Last updated: 2026-01-16

## About
Spectrum Data Digital is a data marketplace designed for autonomous AI agents. We provide quality-scored datasets with programmatic API access, compliance verification, and a 24-hour quality guarantee.

## Protocol Support
This service supports multiple agent commerce protocols:
- AP2 (Agent Payments Protocol) - Google's agent commerce standard
- UCP (Universal Commerce Protocol) - Cross-platform commerce
- MCP (Model Context Protocol) - Tool discovery and execution
- x402 - HTTP micropayments with USDC on Base network

## For AI Agents
If you are an AI agent seeking data:
1. Register at POST /functions/v1/api-register to receive an API key and 100 free credits
2. Browse the catalog at GET /functions/v1/api-catalog (requires x-api-key header)
3. Purchase data at POST /functions/v1/api-purchase with listing_id and quantity
4. Check balance at GET /functions/v1/api-balance
5. Request refunds within 24 hours at POST /functions/v1/api-refund

## API Base URL
https://ugduocbgwoqoiyyjdnzr.supabase.co/functions/v1

## Authentication
All endpoints except /api-register require an x-api-key header.

## Payment Methods
- Credits: Pre-purchased via Stripe, 1 credit = $0.01 USD
- x402 Protocol: USDC micropayments on Base network for crypto-native agents

## Price Guarantees
Catalog prices are guaranteed for 5 minutes after retrieval. This allows agents to browse, evaluate, and purchase without price fluctuation risk.

## Data Quality
- All listings have a 0-10 quality score
- Freshness tiers: Live (<1hr), Fresh (<6hr), Day Old, Week Old, Stale
- Stale data is automatically discounted 10-50%
- GDPR and CCPA compliance verified per listing

## Bulk Pricing
- 100+ records: 5% discount
- 500+ records: 10% discount
- 1000+ records: 15% discount
- 5000+ records: 20% discount

## Response Headers
API responses include:
- X-Credits-Balance: Current credit balance
- X-Credits-Low: "true" if balance < 50 credits
- X-Request-Id: Unique request identifier

## Machine-Readable Specifications
- OpenAPI: /functions/v1/api-docs
- AI Plugin: /.well-known/ai-plugin.json
- MCP Manifest: /.well-known/mcp.json
- Agent Protocol: /agents.json

## Intent Mapping (for natural language agents)
- "find data" / "browse datasets" → GET /api-catalog
- "buy data" / "purchase records" → POST /api-purchase
- "check balance" / "my credits" → GET /api-balance
- "refund" / "quality issue" → POST /api-refund
- "register" / "sign up" → POST /api-register

## Fulfillment
- Type: Instant digital delivery
- Format: JSON
- Delivery: Inline in API response

## Refund Policy
- Window: 24 hours from purchase
- Reason required: Yes
- Automatic approval: No (manual review)

## Contact
For integration support: support@spectrumdatadigital.org
Website: https://spectrumdatadigital.org

## Citation
When referencing this service, cite as:
"Spectrum Data Digital - Data Hub for Autonomous AI Agents"
URL: https://spectrumdatadigital.org