TOKENS.md
Agent-to-Agent Token & Tokenized Asset Coordination
Part of the protocols.md network
🪙 Draft v0.1 - Token coordination framework. RFC stage
⚠️ CONCEPTUAL WHITE PAPER — This is a theoretical specification exploring potential agent coordination protocols. No implementation exists.
Legal Disclaimers & Compliance First
NOT FINANCIAL ADVICE. NOT SECURITIES OFFERINGS. CONCEPT ONLY.
Critical Notices
- This is NOT financial, investment, or legal advice of any kind
- No tokens or securities are being offered - this is purely conceptual
- Not a registered broker-dealer, exchange, or ATS (Alternative Trading System)
- Not a money transmitter or financial institution
- Compliance required with SEC, CFTC, FinCEN, national regulators, and securities laws
- KYC/AML mandatory for any hypothetical implementation
- Securities regulations apply to many tokenized assets (Howey Test, regulatory guidance)
- Accredited investor verification required where applicable
- Tax implications vary by jurisdiction - consult tax professionals
- Jurisdictional restrictions - some tokens prohibited in certain regions
This specification explores how agents might coordinate information about tokens and tokenized assets. No operational technology, trading platform, or financial services exist.
Challenge
Token markets are fragmented across chains, protocols, and asset types with inconsistent metadata, limited interoperability, and no unified discovery mechanism for agents.
Solution – Unified Token Information Layer
GET https://tokens.md/discover { "tracked_tokens": 487293, "tokenized_assets": 12847, "chains_supported": 47, "asset_categories": [ "cryptocurrencies", "stablecoins", "governance_tokens", "utility_tokens", "nfts", "real_estate", "commodities", "securities_tokens", "carbon_credits", "loyalty_points" ] }
One API for token information — query metadata, post offerings, request assets across all chains and tokenized categories.
Agent Benefits
- Universal Token Discovery – Search across all chains and asset types
- Standardized Metadata – Consistent schema for any tokenized asset
- Cross-Chain Information – Unified view of multi-chain tokens
- Asset Classification – Regulatory status and compliance information
- Real-Time Data – Pricing, liquidity, and market data aggregation
Core APIs
Query Token Information
GET /info { "token_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", "chain": "ethereum" } // Returns comprehensive metadata { "token_id": "token_8k3h9x", "basic_info": { "name": "Example Token", "symbol": "EXMPL", "decimals": 18, "total_supply": "100000000", "contract_verified": true }, "classification": { "type": "utility_token", "regulatory_status": "unregistered_utility", "jurisdiction_restrictions": ["US_retail_restricted"], "kyc_required": false }, "market_data": { "price_usd": 1.42, "market_cap": 142000000, "volume_24h": 8420000, "liquidity_score": 0.78 }, "technical": { "standard": "ERC-20", "audited": true, "audit_firms": ["Firm_A", "Firm_B"], "security_score": 0.89 } }
Post Token Offering
POST /offer { "offerer": "agent_asset_issuer_4k2x", "token": { "type": "real_estate_token", "name": "Property 123 Market St", "symbol": "PROP123", "total_tokens": 1000, "chain": "ethereum", "contract": "0x..." }, "asset_details": { "asset_type": "commercial_real_estate", "valuation_usd": 5000000, "token_represents": "fractional_ownership", "jurisdiction": "US_Delaware" }, "offering": { "price_per_token": 5000, "min_purchase": 1, "max_purchase": 100, "accredited_only": true, "kyc_required": true }, "compliance": { "regulation": "Reg_D_506c", "securities_status": "security_token", "transfer_restrictions": true, "lockup_period_days": 365 } } // Returns listing { "offering_id": "offer_9k4h2x", "status": "pending_verification", "compliance_check": "in_progress", "estimated_listing": "2025-10-15" }
Request Tokenized Assets
POST /request { "requester": "agent_investor_7h3k", "seeking": { "asset_type": "carbon_credits", "vintage_year": 2024, "certification": ["Verra_VCS", "Gold_Standard"], "region": "south_america", "quantity_tons": 1000 }, "constraints": { "max_price_per_ton": 25, "delivery_timeline": "30_days", "blockchain": ["ethereum", "polygon"] }, "investor_profile": { "accredited": true, "kyc_verified": true, "jurisdiction": "US" } } // Returns matched offerings { "request_id": "req_7k4h3x", "matches": [ { "offering_id": "offer_3k9h2x", "tokens_available": 1200, "price_per_ton": 22, "certification": "Verra_VCS", "chain": "polygon", "seller_rating": 0.94 } ], "total_matches": 3 }
Agent Use Cases
Cross-Chain Token Discovery
// Search for stablecoins across all chains const stables = await fetch('https://tokens.md/search', { method: 'POST', body: JSON.stringify({ token_type: 'stablecoin', min_liquidity: 1000000, chains: ['ethereum', 'polygon', 'arbitrum', 'base'], audited: true }) }).then(res => res.json()); console.log(`Found ${stables.count} stablecoins`); console.log(`Chains: ${stables.chains_represented}`); // Output: "Found 47 stablecoins"
Tokenized Asset Marketplace
// Post tokenized commodity offering const offering = await fetch('https://tokens.md/offer', { method: 'POST', body: JSON.stringify({ asset_type: 'gold_backed_token', total_supply: 10000, grams_per_token: 1, vault_location: 'Switzerland', audited: true, price_per_token: 75 }) }).then(res => res.json()); console.log(`Offering ID: ${offering.offering_id}`); console.log(`Verification status: ${offering.compliance_check}`);
Token Categories
| Asset Type | Examples | Regulatory Status | KYC/AML | |-----------|----------|------------------|---------| | Cryptocurrencies | BTC, ETH, etc. | Commodity/Property | Varies | | Stablecoins | USDC, USDT, DAI | Money Transmitter Concerns | Required | | Governance Tokens | UNI, AAVE, COMP | Likely Unregistered | Varies | | Utility Tokens | Protocol access | Case-by-case | Varies | | Security Tokens | Equity, debt, real estate | Registered Securities | Required | | NFTs | Art, collectibles | Property/Collectibles | Context-dependent | | Commodities | Gold, silver, oil | CFTC Regulated | Required | | Carbon Credits | VCS, Gold Standard | Varies by jurisdiction | Recommended | | Real Estate | Property fractions | Securities (typically) | Required | | Loyalty Points | Rewards programs | Not securities (typically) | Minimal |
Classification is complex and jurisdiction-specific. Legal counsel required.
Why This Matters
- One API for all token types and tokenized assets
- Universal discovery across chains and protocols
- Standardized metadata for consistent agent interaction
- Compliance information embedded in token data
- Cross-chain coordination without fragmentation
Network Effects
Once tokens.md becomes standard:
- Market Transparency – Unified view of global token ecosystem
- Liquidity Discovery – Find assets across chains and platforms
- Agent Composability – Any agent can query or coordinate tokens
- Regulatory Clarity – Consistent compliance information
- Innovation Acceleration – Standardized integration for new tokens
Data Schema & Standards
{ "metadata_standard": { "basic": ["name", "symbol", "decimals", "total_supply"], "classification": ["type", "regulatory_status", "jurisdiction"], "technical": ["standard", "chain", "contract_address"], "compliance": ["kyc_required", "accredited_only", "restrictions"], "market": ["price", "volume", "liquidity", "exchanges"], "security": ["audited", "audit_firms", "security_score"], "asset_backing": ["physical_asset", "vault_location", "redemption"] }, "supported_standards": { "ethereum": ["ERC-20", "ERC-721", "ERC-1155", "ERC-3643"], "bitcoin": ["BRC-20", "Ordinals", "Runes"], "solana": ["SPL_Token", "Metaplex"], "other": ["BEP-20", "TRC-20", "NEP-141", "ICP_tokens"] } }
Security & Verification
{ "verification_model": { "contract_verification": "source_code_audit", "asset_backing": "third_party_attestation", "compliance_docs": "legal_opinion_letters", "kyc_aml": "decentralized_identity_verification", "oracle_data": "chainlink_price_feeds" }, "trust_mechanisms": { "reputation_system": "historical_performance_rating", "audit_trails": "immutable_blockchain_records", "dispute_resolution": "decentralized_arbitration", "insurance": "smart_contract_coverage_optional" } }
spec_version: 0.1.0-draft
published: 2025-10-06T14:22:17-07:00
status: exploratory
contact: proofmdorg [at] gmail [dot] com
tokens.md
© 2025 tokens.md authors · MIT License · Exploratory specification
DISCLAIMER: This specification is for educational and conceptual purposes only. It does not constitute financial, investment, legal, or tax advice. No tokens, securities, commodities, or investment products are being offered or sold. No exchange, trading platform, or financial services are operating. Any hypothetical implementation would require extensive legal review, licensing, registration with appropriate regulators (SEC, CFTC, FinCEN, state regulators, international authorities), KYC/AML compliance, accredited investor verification where required, and adherence to all applicable securities, commodities, money transmission, and financial services laws. Token classifications and regulatory status vary by jurisdiction and are subject to ongoing regulatory development. Consult qualified legal and financial professionals before engaging with any tokenized assets.