{"uid":"cap_JaQqVEozwfR9uxZCBh7xy","slug":"honcho-memory-api-4d9d615b","name":"Honcho Memory API","description":"Pay-per-request conversational memory for AI agents. Store messages, query memory, and retrieve learned representations. Powered by Honcho.","url":"https://agentcash.honcho.dev/api/honcho/chat","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"peer":{"type":"string","minLength":1,"description":"Peer ID — a stable identifier for a participant (agent, user, assistant)."},"query":{"type":"string","minLength":1,"description":"Natural language question to ask about this peer's memory."},"target":{"type":"string","description":"Target peer ID — if set, queries what the peer knows about the target rather than its global memory."},"session":{"type":"string","minLength":1,"description":"Scope the query to a session."},"reasoning_level":{"enum":["minimal","low","medium","high","max"],"type":"string","description":"Reasoning depth (determines price). minimal=$0.001 (basic conclusions, instant), low=$0.01 (efficient synthesis, instant), medium=$0.05 (steerable reasoning, fast), high=$0.10 (deep synthesis, async), max=$0.50 (research-grade, async). Defaults to \"low\"."}}},"responseSchema":null,"example":{"request":{"peer":"test-agent-001","query":"What topics have been discussed in our conversations?","reasoning_level":"minimal"},"response":{"content":"I haven't found any information about topics that have been discussed in our conversations."}},"exampleRequest":{"peer":"test-agent-001","query":"What topics have been discussed in our conversations?","reasoning_level":"minimal"},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vCG-CS_V-dcfHyLnUPAqI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Query conversational memory for an AI agent or user peer, retrieving learned representations and synthesized conclusions from stored interactions.","exampleAgentPrompt":"Ask Honcho what it remembers about user 'alice-123' — specifically, what does it know about her preferences and past issues? Use medium reasoning depth.","exampleUseCases":null,"resultDescription":"A synthesized, natural language answer derived from the peer's stored conversational memory, with depth and latency depending on the chosen reasoning_level (e.g. minimal for instant basic conclusions, high for deep async synthesis).","failureModes":["Missing required 'peer' field returns validation error","Missing required 'query' field returns validation error","Invalid 'reasoning_level' enum value returns 400 error","Unknown peer ID returns empty or null memory response","Payment failure (x402) if USDC balance is insufficient","Async reasoning levels (high/max) may timeout if polled synchronously","Session ID scoping returns empty results if session has no stored messages"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to recall or synthesize what it has learned about a specific user or peer from past conversations, especially when reasoning depth is configurable. Prefer over generic vector search when you want natural language memory queries with Honcho's peer/session scoping model and pay-per-request pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-25T23:14:02.979Z","lastSuccessfullyRanAt":"2026-06-25T23:14:02.979Z","lastHealthCheckAt":"2026-09-15T00:37:37.874Z","isFirstParty":false}