{"version":"1.0","policy":"Automated traffic is welcome. Pay-to-crawl pricing applies — agents must hold credits to access metered endpoints. Human visitors get a one-time trial; automated agents do not.","model":"credit-metered","currency":"USD","marginMultiplier":2.5,"minTopupUsd":10,"creditsPerUsd":100,"trialAvailable":{"humans":true,"humanTrialCredits":25,"agents":false},"paidEndpoints":{"/api/topics":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"window":"5m|15m|30m|1h|6h|24h (default 30m)","region":"Global|US|EU|... (default Global)","platform":"All|x|reddit|rss|... (default All)"},"exampleResponse":[{"topicId":"8c1d15ee-cb45-40ec-95bd-40e90c31615b","headline":"Bitcoin ETF approval rumors","category":"crypto","terminalRankScore":8.4,"volume5m":142,"acceleration5m":0.42,"crossPlatformScore":6.7,"narrativeType":"stable|emerging|escalating","noveltyScore":0.71,"riskScore":22}]},"/api/topics/{id}":{"credits":1,"priceUsd":0.01,"method":"GET","exampleResponse":"Same shape as a single element of /api/topics — single topic with full metrics."},"/api/topics/{id}/detail":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"signalLimit":"1-200 (default 50)"},"exampleResponse":"Topic shape + signals (text excerpts), entities, recent snapshots, narrative analysis if available."},"/api/topics/search":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"q":"(required) free-text query","limit":"1-200 (default 20)"},"exampleResponse":[{"topicId":"...","headline":"...","similarity":0.83,"signalEmbeddingCount":47}]},"/api/terminal/top":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"window":"5m|15m|... (default 5m)","limit":"1-200 (default 50)"},"exampleResponse":"Ranked TerminalTopItem array — { topicId, headline, terminalRankScore, signalCount, ... }."},"/api/terminal/memes":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"limit":"1-200 (default 30)"},"exampleResponse":[{"id":"...","perceptualHash":"...","reuseCount":12,"velocityScore":3.2,"distinctTopicCount":4}]},"/api/terminal/narratives":{"credits":1,"priceUsd":0.01,"method":"GET","exampleResponse":"Ranked narrative analyses per topic."},"/api/terminal/graph":{"credits":1,"priceUsd":0.01,"method":"GET","exampleResponse":"Graph edges between topics (shared entities, semantic similarity)."},"/api/terminal/emerging":{"credits":1,"priceUsd":0.01,"method":"GET","exampleResponse":"Topics with high acceleration but low absolute volume — the early signals."},"/api/entities":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"window":"30m|24h|... (default 30m)","limit":"1-200 (default 30)","q":"(optional) search filter"},"exampleResponse":[{"name":"Federal Reserve","type":"organization","mentionCount":84,"topicCount":6,"averageConfidence":0.87}]},"/api/entities/{name}/detail":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"window":"24h|7d|... (default 24h)"},"exampleResponse":"Entity summary + linked topics + recent signals + per-hour timeline + per-platform mention breakdown."},"/api/trend-engine/active":{"credits":1,"priceUsd":0.01,"method":"GET","queryParams":{"limit":"1-200 (default 50)","onlySignificant":"true|false (default false; true filters to FDR-significant only)"},"exampleResponse":[{"clusterId":"...","headline":"...","pvScore":2.41,"nStar":0.93,"lambdaGrowth":0.0042,"doublingTimeMinutes":165.2,"eventCount":132,"sourceEntropy":1.05,"entropySlope":0.31,"lrStatistic":14.8,"fdrSignificant":true,"origin":{"source":"x","modality":"text","signalId":"...","confidence":0.78},"estimatedAt":"2026-06-09T..."}]},"/api/trend-engine/clusters/{id}/forensics":{"credits":5,"priceUsd":0.05,"method":"GET","exampleResponse":"Full numerical state for one cluster: μ (per-source baseline), α (excitation matrix), nStar, λ, source entropy + slope, log-L Hawkes vs Poisson, LR statistic, FDR q-value, PV score, propagation tree (parent probabilities), and the resolved origin attribution."}},"freeEndpoints":["/api/billing/balance","/api/billing/invoice","/api/billing/webhooks/nowpayments","/api/billing/usage","/api/billing/ledger","/api/billing/claim-code","/api/crawl/pricing","/.well-known/pay-to-crawl.json","/api/trend-engine/validation","/api/health/pipeline"],"supportedPayCurrencies":["btc","eth","sol","usdc","usdtsol","btc","eth","sol","usdc","usdtsol"],"paymentProtocol":{"subjectHeader":"X-Motion-Subject","subjectFormat":"code:ms-XXXX-XXXX-XXXX (lowercase hex). Generate locally or accept the subjectId returned in a 402 response.","invoiceEndpoint":"https://api.motionscreener.com/api/billing/invoice","invoiceMethod":"POST","invoiceBody":{"usdAmount":"number >= 10","payCurrency":"sol|eth|btc|usdc|usdtsol"},"invoiceResponse":"Returns payAddress, payAmountNative, chain, validUntil","balanceEndpoint":"https://api.motionscreener.com/api/billing/balance","balanceMethod":"GET","balanceAuth":"Include X-Motion-Subject header. No further authentication.","chainConfirmationTimes":{"sol":"~1s","usdc":"~1s on Solana / ~15s on Ethereum","eth":"~15s","btc":"10-30 minutes"}},"terms":{"consumable":"Credits are consumable. Not redeemable for cash.","refunds":"No refunds. Disputes considered for clear billing errors only.","rateChanges":"Rates may change. Re-fetch this document before each significant top-up.","privacy":"No identity collected. The subjectId is the only handle."},"pricingUrl":"https://api.motionscreener.com/api/crawl/pricing","wellKnown":"https://api.motionscreener.com/.well-known/pay-to-crawl.json","openApi":{"spec":"https://api.motionscreener.com/swagger/v1/swagger.json","ui":"https://api.motionscreener.com/swagger","description":"Full OpenAPI 3.0 surface — every endpoint, parameter, and response type."},"contact":"https://api.motionscreener.com"}