# Tinkrr Intelligence API

> Real-time Bitcoin network intelligence and YouTube video intelligence for autonomous AI agents.
> Pay-per-call via x402 (USDC on Base mainnet). No account, no API key, no subscription required.

## How to use
1. Make a request to any endpoint below.
2. Receive HTTP 402 with payment details in the PAYMENT-REQUIRED header.
3. Pay the stated USDC amount on Base mainnet using the x402 protocol.
4. Retry the request with your X-PAYMENT header. Receive the result.

## Protocol
- Payment: x402 v2
- Token: USDC (Base mainnet)
- Facilitator: https://api.cdp.coinbase.com/platform/v1/x402/facilitate
- Merchant: 0xc3d6162d20Cdc2f17A62eA6E81B248758d6c4f0C

## Bitcoin Intelligence Endpoints

GET  https://tinkrr-api.tinkrr.workers.dev/btc/fees
     Price: $0.005 USDC
     Real-time fee estimates (sat/vB) with congestion tier and cost examples for next-block, 30-min, 1-hr.

GET  https://tinkrr-api.tinkrr.workers.dev/btc/mempool/intel
     Price: $0.003 USDC
     Mempool congestion tier, blocks-to-clear estimate, RBF timing signal, and agent decision flags.

GET  https://tinkrr-api.tinkrr.workers.dev/btc/address/risk
     Price: $0.009 USDC
     AML/compliance risk score (0-100) for a Bitcoin address. Signals include CoinJoin, high counterparty count, pass-through patterns.

POST https://tinkrr-api.tinkrr.workers.dev/btc/tx/decode
     Price: $0.009 USDC
     Decode and analyse a Bitcoin transaction by txid or raw hex. Returns inputs, outputs, fee rate, RBF status, category.

GET  https://tinkrr-api.tinkrr.workers.dev/btc/intel
     Price: $0.02 USDC
     COMPOSITE — address risk score + live network fee context + mempool state + spend-timing synthesis in one call. Cheaper than calling risk, fees, and mempool separately.

## Video Intelligence Endpoints

POST https://tinkrr-api.tinkrr.workers.dev/video/analyze
     Price: $0.15 USDC
     YouTube video → complete content campaign kit: virality score, viral clips, social media copy for 6 platforms.

POST https://tinkrr-api.tinkrr.workers.dev/video/transcript
     Price: $0.03 USDC
     YouTube video transcript, key points, chapters, and executive summary.

POST https://tinkrr-api.tinkrr.workers.dev/video/script
     Price: $0.05 USDC
     Generate a complete YouTube script from a topic: hook, timed sections, visual directions.

POST https://tinkrr-api.tinkrr.workers.dev/video/trend
     Price: $0.20 USDC
     What is trending on YouTube in a niche right now: topics, formats, hooks, content opportunity.

POST https://tinkrr-api.tinkrr.workers.dev/video/compete
     Price: $0.35 USDC
     Compare 2-3 YouTube videos: virality scores, strengths, what to steal, content gap opportunity.

POST https://tinkrr-api.tinkrr.workers.dev/video/channel
     Price: $0.50 USDC
     Analyse a YouTube channel: content strategy, strengths, weaknesses, competitor positioning.

POST https://tinkrr-api.tinkrr.workers.dev/video/intel
     Price: $0.20 USDC
     COMPOSITE — transcript + engagement read + virality index + trend context + recommended follow-up, enriched with real view/like/comment stats, in one call. Replaces stringing transcript, analyze, and trend together.

## Developer Intelligence Endpoints

GET  https://tinkrr-api.tinkrr.workers.dev/gh/repo/intel
     Price: $0.02 USDC
     COMPOSITE - repository health for any public GitHub repo: 30/90-day commit and release velocity with trend, contributor concentration / bus factor, median issue response time, and a synthesized trust tier with rationale.

POST https://tinkrr-api.tinkrr.workers.dev/gh/dep/risk
     Price: $0.03 USDC
     Supply-chain risk score (0-100) for an npm or PyPI package (or GitHub repo directly): deprecation, abandonment, maintainer drift, release-gap anomaly, ownership transfer signals - with a provenance block (upstream timestamps + SHA-256 evidence hash) agents can cite.

## Discovery
- Full manifest:  https://tinkrr-api.tinkrr.workers.dev/services.json
- x402 manifest:  https://tinkrr-api.tinkrr.workers.dev/.well-known/x402.json
- MCP manifest:   https://tinkrr-api.tinkrr.workers.dev/mcp
- Agent card:     https://tinkrr-api.tinkrr.workers.dev/.well-known/agent-card.json

## Contact
hello@tinkrr.app — https://tinkrr.app