# Blackbird Member Wallet Retrieval

> Blackbird Member Wallet Retrieval is a paid API for AI agents from the-stables-blackbird-api.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Retrieves the authenticated Blackbird member's MEMBERSHIP and SPENDING wallet details, auto-provisioned for all members.

## Facts

- Endpoint: GET https://the-stables-blackbird-api.vercel.app/api/users/me/wallets
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackbird-member-wallet-retrieval-21830453
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sw4bBeZ97jYgllB5t4zTE

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 blackbird-member-wallet-retrieval-21830453
```

Example prompt: What are the current balances and addresses of my Blackbird membership and spending wallets at The Stables?

## When to prefer this

Use this endpoint when an AI agent or application needs to inspect the authenticated Blackbird member's wallet state — specifically their membership and spending wallets — before initiating a payment, checking a reward balance, or verifying account provisioning. Prefer this over generic blockchain wallet lookups because it returns Blackbird-specific wallet roles (membership vs spending) already associated with the member's Blackbird identity, not just on-chain balances.

## Known failure modes

- 401 Unauthorized if no valid Blackbird identity is presented (no JWT, no SIWX, no linked agent wallet)
- 402 Payment Required on first call if x402 payment of $0.005 USDC is not included
- 403 Forbidden if the token or signature does not match a valid member
- 404 Not Found if wallets have not been provisioned (edge case for very new accounts)
- 500 Internal Server Error if the upstream Blackbird service is unavailable

## How this service works

Your MEMBERSHIP and SPENDING wallets (auto-provisioned for all members). Requires a Blackbird identity: link your agent wallet once at /connect, then call with x402 + SIWX (first call pays, later SIWX-signed calls are free); or pass a member JWT in the X-Blackbird-Token header.

## Output

Returns details for two auto-provisioned wallets associated with the authenticated Blackbird member: a MEMBERSHIP wallet and a SPENDING wallet. Each wallet entry includes its address, balance, and relevant metadata. The response reflects the current state of wallets for the authenticated identity.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-member-wallet-retrieval-21830453/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stables-blackbird-api.vercel.app](https://www.zero.xyz/host/the-stables-blackbird-api.vercel.app/llms.txt)