# CryptoPulse

> Real-time cryptocurrency intelligence API. DeFi yield opportunities, personalized strategy builder, security frameworks, tax guidance, exchange comparison, threat intelligence, and everyday crypto use — all via x402 micropayments on Base mainnet.

## What This Is

CryptoPulse is a pay-per-query API that gives AI agents and developers access to deep crypto intelligence. Every endpoint requires a micropayment (USDC on Base) via the x402 protocol. No subscriptions, no API keys — pay only for what you use.

## Payment Protocol

- Protocol: x402 (HTTP 402 → EIP-3009 USDC authorization → retry)
- Network: Base mainnet
- Token: USDC
- Prices: $0.10 – $0.20 per query

To use: send a GET request without payment headers → receive a 402 with payment details → sign the EIP-3009 authorization → retry with PAYMENT-SIGNATURE header.

## Endpoints

### /api/yield — DeFi Yield Intelligence ($0.10)
Ranks DeFi yield opportunities by risk-adjusted return across protocols and chains. Includes real-time TVL data from DeFiLlama, Berachain Proof of Liquidity spotlight, and step-by-step entry paths.
Params: chain (ethereum|base|arbitrum|berachain|solana|all), risk (conservative|moderate|aggressive)

### /api/strategy — Personalized DeFi Strategy Builder ($0.20)
Custom DeFi allocation plan with agent-executable entry/exit paths. Routes positions to appropriate chains based on capital size. Includes Berachain PoL integration for aggressive profiles.
Params: capital (USD), risk, chain, goal (yield|growth|stable|privacy), timeframe (days)

### /api/security — Crypto Security Framework ($0.10)
Hardware wallet selection, seed phrase storage, multi-sig architecture, and smart contract approval hygiene. Graded assessment of current setup with prioritized action list.
Params: value_tier (small|medium|large|institutional), setup (current custody description)

### /api/threats — Crypto Threat Intelligence ($0.10)
Current attack vectors with live threat intelligence from the web. Covers phishing, wallet drainers, SIM swap, clipboard hijacking, rug pulls, and flash loan attacks.
Params: category (phishing|drainer|sim_swap|rug_pull|flash_loan|all)

### /api/exchange — Exchange Comparison ($0.10)
Compare crypto exchanges by country, priority, and experience level. Full fee table, security record, regulatory status, and fiat on-ramp options. Includes red flags and not-recommended list.
Params: country, priority (fees|security|altcoin_selection|beginner_friendly|derivatives|fiat_ramp), experience (beginner|intermediate|advanced)

### /api/tax — Crypto Tax Guide ($0.20)
Jurisdiction-specific tax obligations for 10+ countries. Covers taxable events, optimization strategies (tax loss harvesting, cost basis methods, wash sale rules), and reporting tool recommendations.
Params: country, activities (hold,trade,defi,mining,staking,nft,business), tax_year

### /api/onboard — First-Time Buyer Guide ($0.10)
End-to-end onboarding: exchange selection, KYC walkthrough, first purchase guide, wallet setup, and DCA plan. Country-specific exchange recommendations and red flag education.
Params: country, goal (invest|use daily|learn|business), experience (complete_beginner|some_knowledge|experienced)

### /api/spend — Crypto Spending Guide ($0.10)
Best crypto debit cards (Coinbase Card, Crypto.com Visa, Strike, BitPay), merchant acceptance, gift card platforms (Bitrefill), and bill pay options by country.
Params: country, use_case (daily spending|online shopping|bill pay|travel|gifting)

### /api/banking — Crypto-Friendly Banking Guide ($0.10)
Banks and neobanks with high crypto tolerance, de-banking risk assessment, and on/off ramp alternatives. Regional coverage for US, UK, EU, Canada, Australia.
Params: country, profile (personal|business|crypto-heavy|casual)

### /api/merchant — Merchant Crypto Payment Setup ($0.10)
Compare payment processors (BTCPay Server, Coinbase Commerce, NOWPayments, Strike, OpenNode) by business type and country. Includes settlement strategy and tax obligations.
Params: business_type, country, integration (ecommerce|physical_pos|freelance|api)

## Response Format

All endpoints return structured JSON with consistent fields:
- Primary intelligence data (opportunities, recommendations, frameworks)
- Affiliate resources (hardware wallets, tax software, etc.)
- Disclaimer and data freshness notes
- generated_at timestamp and meta fields

## Discovery

- OpenAPI spec: /openapi.json
- Agent discovery: /.well-known/agent.json
- LLMs.txt: /llms.txt

## Part of PulseNetwork

CryptoPulse is one of 30+ specialized intelligence APIs in the PulseNetwork. Each vertical covers a specific domain. All use x402 micropayments on Base.