{"openapi":"3.1.0","info":{"title":"ApexScout AgentCore Gateway Import","version":"v2.2.107-audit-builder-recommended-first-action","summary":"OpenAPI import surface for AgentCore-style x402 buyer agents.","description":"ApexScout is an inbound-only x402 trust and monetization intelligence API. Paid routes return HTTP 402 JSON before payment and one JSON response after buyer-controlled x402 payment. This is seller-side import metadata for AgentCore Payments-style buyers, not an AWS, Coinbase, or Stripe endorsement claim."},"servers":[{"url":"https://agent-research-brief-api-production.up.railway.app"}],"tags":[{"name":"free-readiness","description":"Free owned surfaces that help a buyer inspect ApexScout before payment."},{"name":"paid-x402","description":"x402 protected paid routes. Unpaid calls should return HTTP 402 JSON."}],"x-apexscout":{"release":"v2.2.107-audit-builder-recommended-first-action","liveMode":"zero-contact-inbound-only","productionRail":"Base mainnet x402","network":"eip155:8453","firstPaidRoute":"/api/opportunity-check","builderMonetizationRoute":"/api/agent-revenue-audit","buyerAgentSpendPolicy":"/api/agentcore-payments-policy","buyerAgentSpendPolicyWellKnown":"/.well-known/apexscout-spend-policy.json","buyerAgentStart":"/api/agentcore-buyer-start","agentCorePaymentsBuyerGuide":"/api/agentcore-payments-buyer-guide","agentCorePaymentHandoff":"/api/agentcore-payment-handoff","agentPaymentTractionBrief":"/api/agent-payment-traction-brief","bazaarSearchReadiness":"/api/bazaar-search-readiness","discoverySearchFit":"/api/discovery-search-fit","buyerAgentSpendPassport":"/api/agent-spend-passport","buyerAgentSpendPassportPrepare":"/api/agent-spend-passport/prepare","x402MetadataPreflight":"/api/x402-metadata-preflight","x402MetadataPreflightCheck":"/api/x402-metadata-preflight/check","recommendedNoSpendPreflight":"/api/agent-spend-passport/prepare","passportFirstCta":"Not sure what to buy? Generate a free Agent Spend Passport before paying.","passportExplanation":"The Passport does not spend money. It recommends the right route, checks budget fit, warns about sensitive fields, and gives a safe copy-paste paid-call payload.","passportFirstBuyerPath":["Inspect /x402-proof.","Generate a free /agent-spend-passport.","If the Passport recommends the $5 audit, preview /agent-revenue-audit-preview before paying.","If the Passport recommends the $5 audit, build a valid request at /agent-revenue-audit-builder before paying.","Run the free /x402-metadata-preflight before any paid retry if the buyer metadata includes a resource URL, payment description, reason string, or payload preview.","If Passport recommends /api/opportunity-check, use the $0.01 route.","If Passport recommends /api/agent-revenue-audit, use the $5 route only with approved budget.","Stop if Passport says stop."],"recommendedSessionCapUsd":"5.01","publicMetrics":"aggregate-only","buyerLevelDataPublic":false,"agentCorePaymentsCompatibleSellerSurface":true,"officialAwsCoinbaseEndorsementClaimed":false,"sourceUrls":{"coinbase":"https://www.coinbase.com/blog/introducing-amazon-bedrock-agentcore-payments-powered-by-x402-and-coinbase","aws":"https://aws.amazon.com/blogs/machine-learning/agents-that-transact-introducing-amazon-bedrock-agentcore-payments-built-with-coinbase-and-stripe/"},"guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"]},"paths":{"/api/opportunity-check":{"post":{"tags":["paid-x402"],"operationId":"apexscoutOpportunityCheck","summary":"Run the cheapest ApexScout paid trust check.","description":"First paid route for buyer agents: x402 trust check, payment proof, light opportunity check, buyer-agent route evaluation, vendor/API/company trust check, and agent payment safety. Send an unpaid request first to receive HTTP 402 JSON, then retry with buyer-controlled x402 payment only if authorized.","x-x402":{"protocol":"x402","rail":"Base mainnet","network":"eip155:8453","price":"$0.01","maxAmountAtomicUnits":"10000","expectedUnpaidStatus":402,"expectedPaidStatus":200,"buyerWalletManagedBy":"AgentCore Payments or another buyer-controlled x402 client","sellerWalletPublicInSpec":false},"x-apexscout-guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["subject","goal"],"properties":{"subject":{"type":"string","description":"Service, API, company, route, or opportunity to evaluate."},"goal":{"type":"string","description":"The buyer-agent decision this check should support."},"buyerType":{"type":"string","description":"Optional buyer segment, such as agentcore-buyer-agent."},"source":{"type":"string","description":"Optional source tag for aggregate attribution."}}}}}},"responses":{"200":{"description":"Paid trust check response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string"},"recommendation":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"commercial":{"type":"object"},"trustProfile":{"type":"object"}}}}}},"402":{"description":"Unpaid x402 payment challenge. Buyer-controlled clients should inspect this before any paid retry.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error","accepts"],"properties":{"error":{"type":"string","const":"payment_required"},"accepts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","const":"eip155:8453"},"amount":{"type":"string","const":"10000"},"price":{"type":"string","const":"$0.01"}}}}}}}}}}}},"/api/agent-revenue-audit":{"post":{"tags":["paid-x402"],"operationId":"apexscoutAgentRevenueAudit","summary":"Run the ApexScout builder monetization audit.","description":"Builder-facing $5 agent revenue audit and x402 builder audit for paid API monetization, route pricing audit, buyer-agent conversion, API monetization strategy, MCP paid tool monetization, and agent API conversion audit. This stays protected by x402 and does not make paid upstream calls.","x-x402":{"protocol":"x402","rail":"Base mainnet","network":"eip155:8453","price":"$5.00","maxAmountAtomicUnits":"5000000","expectedUnpaidStatus":402,"expectedPaidStatus":200,"buyerWalletManagedBy":"AgentCore Payments or another buyer-controlled x402 client","sellerWalletPublicInSpec":false},"x-apexscout-guardrails":["Seller-side import metadata only","Zero-contact and inbound-only","No official AWS, Coinbase, or Stripe endorsement claim","No AWS wallet integration added by ApexScout","No automatic buyer spending","No scraping","No third-party discovery","No outreach automation","No manual messages, posts, DMs, or emails","No paid upstream calls","No fake traction","No buyer-level public data","No settlement rail change","No seller wallet change"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["serviceName","currentOffer","targetBuyer","currentProblem"],"properties":{"serviceName":{"type":"string"},"currentOffer":{"type":"string"},"targetBuyer":{"type":"string"},"currentProblem":{"type":"string","description":"The concrete monetization, pricing, route, or buyer-agent conversion problem the audit should solve."},"currentPaymentRail":{"type":"string"},"riskTolerance":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"Paid monetization audit response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"summary":{"type":"string"},"monetizationDiagnosis":{"type":"string"},"bestFirstPaidRoute":{"type":"object"},"conversionFriction":{"type":"array","items":{"type":"string"}},"sevenDayRevenuePlan":{"type":"array","items":{"type":"string"}}}}}}},"402":{"description":"Unpaid x402 payment challenge. Buyer-controlled clients should inspect this before any paid retry.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error","accepts"],"properties":{"error":{"type":"string","const":"payment_required"},"accepts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","const":"eip155:8453"},"amount":{"type":"string","const":"5000000"},"price":{"type":"string","const":"$5.00"}}}}}}}}}}}},"/api/agentcore-readiness":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCoreReadiness","summary":"Read the seller-side AgentCore x402 readiness packet.","responses":{"200":{"description":"AgentCore readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-payments-policy":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCorePaymentsPolicy","summary":"Read the AgentCore Payments-style buyer-agent spend policy.","responses":{"200":{"description":"AgentCore Payments spend policy JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-buyer-start":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCoreBuyerStart","summary":"Read the AgentCore-style buyer start path.","responses":{"200":{"description":"AgentCore buyer start JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-payments-buyer-guide":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCorePaymentsBuyerGuide","summary":"Read the AgentCore Payments-style buyer guide.","description":"Free no-spend buyer guide from proof to OpenAPI/MCP inspection, builder, payment safety score, unpaid 402, and optional buyer-controlled paid retry.","responses":{"200":{"description":"AgentCore Payments buyer guide JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentcore-payment-handoff":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentCorePaymentHandoff","summary":"Read the AgentCore-style x402 payment handoff.","description":"Free no-spend handoff from OpenAPI/MCP import to route choice, budget approval, unpaid 402 inspection, and optional buyer-controlled x402 paid retry.","responses":{"200":{"description":"AgentCore Payment Handoff JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-payment-traction-brief":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentPaymentTractionBrief","summary":"Read the no-spend agent-payment traction brief.","description":"Free no-spend brief that turns current x402, AgentCore, Bazaar, Solana, and security signals into ApexScout-owned buyer steps before payment.","responses":{"200":{"description":"Agent Payment Traction Brief JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/discovery-search-fit":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutDiscoverySearchFit","summary":"Read ApexScout's aggregate-only Bazaar own-route Search Fit Lab.","description":"Free no-spend search-fit metadata for ApexScout-owned routes. It does not scrape, crawl, store competitor data, make paid calls, or inspect third-party domains beyond official discovery search for own-route presence.","responses":{"200":{"description":"Discovery Search Fit JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agentic-market-bundle-readiness":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgenticMarketBundleReadiness","summary":"Read ApexScout bundle readiness for multi-service x402 orchestrators.","description":"Free no-spend bundle-readiness metadata for using ApexScout as a safe ingredient in a larger x402 workflow. It does not execute payment, scrape, crawl, store competitor data, or expose buyer-level data.","responses":{"200":{"description":"Agentic Market Bundle Readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-spend-passport":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentSpendPassport","summary":"Read the free Agent Spend Passport capability before payment.","responses":{"200":{"description":"Agent Spend Passport capability JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-spend-passport/prepare":{"post":{"tags":["free-readiness"],"operationId":"prepareApexScoutAgentSpendPassport","summary":"Prepare a free no-spend route, budget, privacy, and policy decision before payment.","description":"This route is free. It does not execute payment, make paid upstream calls, store buyer-level data publicly, or guarantee revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["goal"],"properties":{"buyerType":{"type":"string","enum":["buyer-agent","builder","operator","api-founder","unknown"]},"goal":{"type":"string","maxLength":640},"intendedRoute":{"type":"string","enum":["/api/opportunity-check","/api/agent-revenue-audit","unknown"]},"maxBudgetUsd":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared no-spend Spend Passport decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_buy","use_cheaper_route","stop"]},"recommendedRoute":{"type":"string"},"price":{"type":"string"},"maxAmountAtomicUnits":{"type":"string"},"budgetCheck":{"type":"object"},"privacyCheck":{"type":"object"},"policyCheck":{"type":"object"},"copyPastePayload":{"type":"object"}}}}}}}}},"/api/agent-revenue-audit-builder":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentRevenueAuditBuilder","summary":"Read the free Agent Revenue Audit checkout builder metadata.","description":"This route is free. It describes the required $5 audit fields, wallet-cap requirement, no-spend guarantee, and prepare API.","responses":{"200":{"description":"Agent Revenue Audit Builder metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-revenue-audit-builder/prepare":{"post":{"tags":["free-readiness"],"operationId":"prepareApexScoutAgentRevenueAuditRequest","summary":"Prepare a valid $5 Agent Revenue Audit payload before payment.","description":"Free no-spend checkout builder. It validates required fields, wallet cap, metadata safety, and payload shape without making paid calls.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["serviceName","currentOffer","targetBuyer","currentProblem"],"properties":{"serviceName":{"type":"string"},"currentOffer":{"type":"string"},"targetBuyer":{"type":"string"},"currentProblem":{"type":"string","description":"What problem are you trying to solve with this audit?"},"currentPaymentRail":{"type":"string"},"riskTolerance":{"type":"string"},"maxBudgetUsd":{"type":"string"},"walletPerRequestCapUsd":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared no-spend checkout builder decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_pay","fix_required_fields","fix_budget_cap","stop"]},"route":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"budgetCheck":{"type":"object"},"metadataSafety":{"type":"object"},"copyPastePayload":{"type":"object"},"x402CommandShape":{"type":"string"}}}}}}}}},"/api/buyer-agent-payment-safety":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutBuyerAgentPaymentSafetyScore","summary":"Read the free buyer-agent payment safety score metadata.","description":"This route is free. It describes a no-spend score for route contract, required fields, wallet cap, budget approval, metadata safety, duplicate-payment risk, and expected network before payment.","responses":{"200":{"description":"Buyer-Agent Payment Safety Score metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/buyer-agent-payment-safety/score":{"post":{"tags":["free-readiness"],"operationId":"scoreApexScoutBuyerAgentPaymentSafety","summary":"Score an intended ApexScout x402 payment before spend.","description":"Free no-spend payment safety score. It does not execute payment, make paid calls, or expose raw buyer payloads publicly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["route","payloadPreview","maxBudgetUsd","walletPerRequestCapUsd","buyerApprovedSpend"],"properties":{"route":{"type":"string","enum":["/api/opportunity-check","/api/agent-revenue-audit","unknown"]},"method":{"type":"string","enum":["POST","GET"]},"payloadPreview":{"type":"object","additionalProperties":true},"maxBudgetUsd":{"type":"string"},"walletPerRequestCapUsd":{"type":"string"},"expectedPriceUsd":{"type":"string"},"expectedNetwork":{"type":"string","enum":["eip155:8453"]},"buyerApprovedSpend":{"type":"boolean"},"previousPaymentAttempt":{"type":"string","enum":["none","unknown","same-payload-already-paid"]},"paymentResponseAlreadyPresent":{"type":"boolean"},"idempotencyKey":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"200":{"description":"No-spend payment safety decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_pay","fix_route","fix_required_fields","fix_budget_cap","redact_before_payment","stop"]},"score":{"type":"number"},"routeContract":{"type":"object"},"budgetCheck":{"type":"object"},"metadataSafety":{"type":"object"},"duplicatePaymentCheck":{"type":"object"},"copyPastePayload":{"type":["object","null"]},"x402CommandShape":{"type":["string","null"]}}}}}}}}},"/api/mcp-tool-pack":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutMcpToolPack","summary":"Read ApexScout MCP-style tool metadata.","responses":{"200":{"description":"MCP Tool Pack JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent-payment-alpha":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutAgentPaymentAlpha","summary":"Read the nine-layer agent-payment alpha and safety packet.","responses":{"200":{"description":"Agent Payment Alpha Safe Layers JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-batch-settlement":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402BatchSettlementReadiness","summary":"Read readiness-only x402 batch settlement metadata.","description":"This route is free. It does not enable batch settlement, escrow, off-chain voucher acceptance, settlement rail changes, seller wallet changes, or paid calls.","responses":{"200":{"description":"x402 Batch Settlement Readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-metadata-preflight":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402MetadataPreflight","summary":"Read free x402 metadata preflight capability metadata.","description":"This route is free. It explains how buyer agents can classify and redact x402 resource URLs, descriptions, reason strings, and payload previews before a paid retry.","responses":{"200":{"description":"x402 Metadata Preflight JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-metadata-preflight/check":{"post":{"tags":["free-readiness"],"operationId":"checkApexScoutX402MetadataPreflight","summary":"Classify x402 payment metadata before paid retry.","description":"Free no-spend privacy preflight. Returns redacted metadata and a stop/redact/ready decision without making paid calls or returning raw payload previews.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"route":{"type":"string","enum":["/api/opportunity-check","/api/agent-revenue-audit","unknown"]},"resourceUrl":{"type":"string","maxLength":500},"paymentDescription":{"type":"string","maxLength":600},"reason":{"type":"string","maxLength":600},"payloadPreview":{"type":"object","additionalProperties":true},"source":{"type":"string","maxLength":80}}}}}},"responses":{"200":{"description":"x402 metadata privacy decision.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"status":{"type":"string","enum":["ready_to_send","redact_before_payment","stop"]},"piiRisk":{"type":"string","enum":["low","medium","high"]},"privacyCheck":{"type":"object"},"policyCheck":{"type":"object"},"sanitizedMetadata":{"type":"object"}}}}}}}}},"/api/chat-tiny-payment-flow":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutChatTinyPaymentFlow","summary":"Read the chat-native tiny x402 payment flow.","description":"Free no-spend flow showing buyer agents how to prepare a one-cent ApexScout x402 request from chat to unpaid 402 inspection to buyer-controlled paid retry.","responses":{"200":{"description":"Chat-native tiny x402 payment flow JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-security-readiness":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402SecurityReadiness","summary":"Read the no-spend x402 security readiness checklist.","description":"Free no-spend readiness checklist covering AgentCore-style buyer fit, discovery metadata, Solana watch-only posture, route binding, replay risk, duplicate-payment risk, payment-response privacy, and metadata safety.","responses":{"200":{"description":"x402 security readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/bazaar-search-readiness":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutBazaarSearchReadiness","summary":"Read the no-spend Bazaar search readiness card.","description":"Free no-spend Bazaar search card and MCP compatibility card for ApexScout's indexed x402 routes, search terms, schemas, and guardrails.","responses":{"200":{"description":"Bazaar search readiness JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402-proof":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutX402Proof","summary":"Read public proof that ApexScout's x402 rail has worked.","responses":{"200":{"description":"x402 proof JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/buyer-agent-challenge":{"get":{"tags":["free-readiness"],"operationId":"getApexScoutBuyerAgentChallenge","summary":"Read the buyer-agent challenge before payment.","responses":{"200":{"description":"Buyer-agent challenge JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}