# Wicked Memory Semantic Search

> Wicked Memory Semantic Search is a paid API for AI agents from memory.wickedapi.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

Performs semantic (vector) search over an AI agent's own persistent, wallet-scoped memory store using a natural-language query.

## Facts

- Endpoint: GET https://memory.wickedapi.com/memories/search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wicked-memory-semantic-search-db5d1e9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qg7Bv_Lz5G9utWtAAgRUg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wicked-memory-semantic-search-db5d1e9e
```

Example prompt: Search my memory for anything I previously saved about the client negotiation with Acme Corp — show me the top 5 most relevant results.

## When to prefer this

Choose this endpoint when an AI agent needs to semantically recall its own previously stored, wallet-scoped memories using natural language — particularly when exact keyword search would be insufficient and relevance ranking by meaning is needed. It is ideal when you need to retrieve past context, decisions, user preferences, or notes that the agent has accumulated over time. Prefer this over general web search when the information is private and agent-specific, and over exact-match databases when the query intent matters more than keyword overlap. The tag and date filters make it superior when memories are organized or need temporal scoping.

## Known failure modes

- Missing or invalid x-api-key returns an authentication error
- Query parameter 'q' absent or exceeding 2000 characters causes a validation error
- Invalid ISO-8601 format for as_of, created_after, or created_before returns a parsing error
- No memories match the query — returns an empty data array (not an error)
- Tag filter too restrictive — returns empty results when no memory has ALL specified tags
- Payment failure or insufficient balance for $0.001 USDC per call (x402 protocol)
- limit outside 1–50 range returns a validation error

## How this service works

Semantic search over an agent's own persistent memories (wallet-scoped). Free with a valid x-api-key.

## Output

Returns a ranked list of memory objects, each containing a unique ID, the stored text content, a cosine similarity score (0–1) indicating relevance to the query, associated tags, and validity timestamps (valid_from and valid_until). Results are ordered by descending similarity score. Default limit is 10, maximum is 50.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Natural-language query (max 2000 chars)."
      },
      "tags": {
       "type": "string",
       "description": "Comma-separated; memories must have ALL of these tags."
      },
      "as_of": {
       "type": "string",
       "description": "ISO-8601 instant; search the versions valid at that moment."
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Max results (default 10)."
      },
      "created_after": {
       "type": "string",
       "description": "ISO-8601 lower bound on creation time."
      },
      "created_before": {
       "type": "string",
       "description": "ISO-8601 upper bound on creation time."
      },
      "include_superseded": {
       "type": "boolean",
       "description": "Also search superseded (old) versions."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "required": [
         "id",
         "content",
         "score"
        ],
        "properties": {
         "id": {
          "type": "string"
         },
         "tags": {
          "type": "array"
         },
         "score": {
          "type": "number",
          "description": "Cosine similarity computed at query time."
         },
         "content": {
          "type": "string"
         },
         "valid_from": {
          "type": "string"
         },
         "valid_until": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wicked-memory-semantic-search-db5d1e9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.wickedapi.com](https://www.zero.xyz/host/memory.wickedapi.com/llms.txt)