{"openapi":"3.1.0","info":{"title":"Tinkrr Intelligence API","version":"2.2.0","description":"Real-time Bitcoin network intelligence and YouTube video intelligence for autonomous AI agents. Pay per call — no accounts, no API keys. Every paid route accepts x402 v2 (X-PAYMENT) and MPP (Authorization: Payment), both settling in USDC on Base mainnet.","contact":{"email":"hello@tinkrr.app"},"x-guidance":"Call any paid route without credentials to receive a 402 with both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge. Sign an EIP-3009 USDC transferWithAuthorization on Base (chainId 8453) and retry with X-PAYMENT (x402) or Authorization: Payment (MPP). Composite routes /btc/intel and /video/intel bundle several analyses into one cheaper call. Full guidance: https://tinkrr-api.tinkrr.workers.dev/llms.txt"},"servers":[{"url":"https://tinkrr-api.tinkrr.workers.dev"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://tinkrr-api.tinkrr.workers.dev/llms.txt"},"x-agentcash-provenance":{"ownershipProofs":["MCP Registry: app.tinkrr/intelligence (DNS-verified via TXT at tinkrr.app)","https://smithery.ai/servers/shival-tailor/tinkrr-intelligence"]},"paths":{"/btc/fees":{"get":{"operationId":"btc_fees","summary":"Bitcoin Fee Forecast","description":"Real-time fee estimates (sat/vB) with congestion tier and cost examples for next-block, 30-min, 1-hr. Price: $0.005 per call, settled in USDC on Base mainnet.","tags":["bitcoin"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}}}},"/btc/mempool/intel":{"get":{"operationId":"btc_mempool_intel","summary":"Mempool Intelligence","description":"Mempool congestion tier, blocks-to-clear estimate, RBF timing signal, and agent decision flags. Price: $0.003 per call, settled in USDC on Base mainnet.","tags":["bitcoin"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}}}},"/btc/address/risk":{"get":{"operationId":"btc_address_risk","summary":"Address Risk Score","description":"AML/compliance risk score (0-100) for a Bitcoin address. Signals include CoinJoin, high counterparty count, pass-through patterns. Price: $0.009 per call, settled in USDC on Base mainnet.","tags":["bitcoin"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.009"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"parameters":[{"name":"address","in":"query","required":true,"description":"Bitcoin address to score","schema":{"type":"string"}}]}},"/btc/tx/decode":{"post":{"operationId":"btc_tx_decode","summary":"Transaction Decoder","description":"Decode and analyse a Bitcoin transaction by txid or raw hex. Returns inputs, outputs, fee rate, RBF status, category. Price: $0.009 per call, settled in USDC on Base mainnet.","tags":["bitcoin"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.009"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txid":{"type":"string","description":"64-char transaction ID"},"rawHex":{"type":"string","description":"Raw transaction hex string"}},"anyOf":[{"required":["txid"]},{"required":["rawHex"]}],"description":"Provide either txid or rawHex."}}}}}},"/btc/intel":{"get":{"operationId":"btc_intel","summary":"Bitcoin Address Composite Intel","description":"COMPOSITE — address risk score + live network fee context + mempool state + spend-timing synthesis in one call. Cheaper than calling risk, fees, and mempool separately. Price: $0.02 per call, settled in USDC on Base mainnet.","tags":["bitcoin"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"parameters":[{"name":"address","in":"query","required":true,"description":"Bitcoin address to analyse","schema":{"type":"string"}}]}},"/video/analyze":{"post":{"operationId":"video_analyze","summary":"Video Campaign Kit","description":"YouTube video → complete content campaign kit: virality score, viral clips, social media copy for 6 platforms. Price: $0.15 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video URL"}},"required":["url"]}}}}}},"/video/transcript":{"post":{"operationId":"video_transcript","summary":"Video Transcript & Summary","description":"YouTube video transcript, key points, chapters, and executive summary. Price: $0.03 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video URL"}},"required":["url"]}}}}}},"/video/script":{"post":{"operationId":"video_script","summary":"Video Script Generator","description":"Generate a complete YouTube script from a topic: hook, timed sections, visual directions. Price: $0.05 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"string","description":"Video topic"},"style":{"type":"string","description":"educational|entertaining|tutorial"},"duration":{"type":"string","description":"e.g. 3-5 minutes"}},"required":["topic"]}}}}}},"/video/trend":{"post":{"operationId":"video_trend","summary":"YouTube Trend Scanner","description":"What is trending on YouTube in a niche right now: topics, formats, hooks, content opportunity. Price: $0.20 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"niche":{"type":"string","description":"tech|business|education|entertainment|gaming|health"},"region":{"type":"string","description":"US|UK|IN|AU"}},"required":["niche"]}}}}}},"/video/compete":{"post":{"operationId":"video_compete","summary":"Video Competitive Analysis","description":"Compare 2-3 YouTube videos: virality scores, strengths, what to steal, content gap opportunity. Price: $0.35 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.35"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":3,"description":"Array of 2-3 YouTube URLs"}},"required":["urls"]}}}}}},"/video/channel":{"post":{"operationId":"video_channel","summary":"Channel Intelligence","description":"Analyse a YouTube channel: content strategy, strengths, weaknesses, competitor positioning. Price: $0.50 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"type":"string","description":"YouTube channel URL or @handle"}},"required":["channel"]}}}}}},"/video/intel":{"post":{"operationId":"video_intel","summary":"YouTube Video Composite Intel","description":"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. Price: $0.20 per call, settled in USDC on Base mainnet.","tags":["video"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video URL"}},"required":["url"]}}}}}},"/gh/repo/intel":{"get":{"operationId":"gh_repo_intel","summary":"GitHub Repo Health Intel","description":"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. Price: $0.02 per call, settled in USDC on Base mainnet.","tags":["developer"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"parameters":[{"name":"repo","in":"query","required":true,"description":"GitHub repository as owner/name","schema":{"type":"string"}}]}},"/gh/dep/risk":{"post":{"operationId":"gh_dep_risk","summary":"Dependency Supply-Chain Risk","description":"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. Price: $0.03 per call, settled in USDC on Base mainnet.","tags":["developer"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}},{"mpp":{"method":"usdc","intent":"charge","currency":"USD"}}]},"responses":{"200":{"description":"Successful response (JSON)."},"400":{"description":"Invalid input."},"402":{"description":"Payment Required. Carries both an x402 PAYMENT-REQUIRED header and an MPP WWW-Authenticate: Payment challenge (method=usdc, intent=charge, EVM/Base, chainId 8453). Pay with either protocol and retry."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ecosystem":{"type":"string","description":"npm | pypi (with package)"},"package":{"type":"string","description":"Package name on the registry"},"repo":{"type":"string","description":"GitHub repository owner/name (alternative to ecosystem+package)"}},"anyOf":[{"required":["ecosystem","package"]},{"required":["repo"]}],"description":"Provide either { ecosystem, package } or { repo }."}}}}}},"/health":{"get":{"operationId":"health","summary":"Health check","description":"Free liveness probe. No payment, no auth.","security":[],"responses":{"200":{"description":"Service is up."}}}}}}