# Convrgent AI Vault Profile Reader

> Convrgent AI Vault Profile Reader is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Retrieves a persistent human profile from the vault including all accumulated framework outputs, canonical traits, conversation history, and metadata.

## Facts

- Endpoint: POST https://convrgent.ai/api/vault/read
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-9b1cc5ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8l8Kca8XBum8xvD0w04N9

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 convrgent-ai-9b1cc5ed -d '<json body>'
```

Example prompt: Pull up the full vault profile for the user with wallet address 0xAbC123 — I need all their accumulated framework outputs, canonical traits, and conversation history.

## When to prefer this

Use this endpoint when you need to load a previously created and populated human profile from the Convrgent vault, especially when multiple framework outputs have already been accumulated over time. Prefer this over creating a new profile or running fresh analyses when the profile already exists and you want all cached traits, history, and cross-framework synthesis in one call. Ideal as a first step before personalizing communication, generating sales pitches, or running any Convrgent analysis that benefits from prior context.

## Known failure modes

- Profile not found for the given wallet address or ID — returns 404 or empty result
- Invalid or missing wallet address / namespace — returns 400 validation error
- Insufficient USDC balance or x402 payment failure — returns 402 payment required
- Vault is empty or profile has no accumulated data yet — returns minimal or stub profile
- Unauthorized agent namespace attempting to access another agent's profile — returns 403

## How this service works

Retrieve a persistent human profile from the vault with all accumulated framework outputs, canonical traits, text history, and metadata.

## Output

Returns the full persistent human profile object including all accumulated outputs from up to 11 personality frameworks (MBTI, Enneagram, Vedic astrology, Western astrology, Human Design, Chinese astrology, numerology, communication style, psychology, socionics, and cross-system convergence), canonical trait summaries, stored text/conversation history, agent briefing data, and profile metadata such as creation date and last update timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "required": [
      "human_id"
     ],
     "properties": {
      "include": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Framework keys to include (default: all)"
      },
      "human_id": {
       "type": "string",
       "description": "Profile identifier to retrieve"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Alice Chen",
  "human_id": "alice-chen-001",
  "metadata": {
   "created": "2026-03-20T10:00:00Z",
   "updated": "2026-03-20T14:30:00Z",
   "signal_count": 13
  },
  "frameworks": {
   "natal-chart": {
    "sunSign": "Gemini"
   },
   "communication": {
    "tone": "analytical-warm"
   }
  },
  "canonical_traits": [
   {
    "id": "introversion",
    "value": 0.72
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-9b1cc5ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)