# Polymarket Public Profile Lookup

> Polymarket Public Profile Lookup is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.00044/call, status unknown (last checked 2026-10-18).

Returns the public profile information for a Polymarket user given their wallet address.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/public-profile?utm_source=zero.xyz
- Price: $0.00044/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-public-profile-lookup-e90f374f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QHG24g5f_lPKKGzZyLgna

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 aisa-mpp-data-apis-polymarket-public-profile-lookup-e90f374f
```

Example prompt: Can you look up the Polymarket public profile for the wallet address 0x1234567890abcdef1234567890abcdef12345678 and tell me their display name, bio, and whether they have a verified badge?

## When to prefer this

Use this endpoint when you need to resolve a raw Ethereum wallet address into a human-readable Polymarket identity, including display names, social links, and verification status. Prefer this over general blockchain explorers when the user context is specifically Polymarket trading activity or profile enrichment.

## Known failure modes

- Address not found — wallet has no associated Polymarket profile, returns null fields
- Invalid address format — input doesn't match 0x + 40 hex chars pattern, returns validation error
- Unregistered wallet — address exists on-chain but never registered on Polymarket, empty or null profile
- Rate limit or payment failure — insufficient USDC balance for per-request fee

## How this service works

Returns the public profile for a wallet address.

<!-- aisa-pricing:start -->
Published reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns a JSON object with the user's display name, bio, auto-generated pseudonym, X (Twitter) username, profile image URL, verified badge status, proxy wallet address, account creation timestamp, and associated user objects indicating moderator or creator roles.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "The wallet address (proxy wallet or user address)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bio": {
   "type": [
    "string",
    "null"
   ],
   "description": "Profile bio"
  },
  "name": {
   "type": [
    "string",
    "null"
   ],
   "description": "User-chosen display name"
  },
  "users": {
   "type": [
    "array",
    "null"
   ],
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "description": "User ID"
     },
     "mod": {
      "type": "boolean",
      "description": "Whether the user is a moderator"
     },
     "creator": {
      "type": "boolean",
      "description": "Whether the user is a creator"
     }
    },
    "description": "User object associated with a public profile"
   },
   "description": "Array of associated user objects"
  },
  "createdAt": {
   "type": [
    "string",
    "null"
   ],
   "format": "date-time",
   "description": "ISO 8601 timestamp of when the profile was created"
  },
  "pseudonym": {
   "type": [
    "string",
    "null"
   ],
   "description": "Auto-generated pseudonym"
  },
  "xUsername": {
   "type": [
    "string",
    "null"
   ],
   "description": "X (Twitter) username"
  },
  "proxyWallet": {
   "type": [
    "string",
    "null"
   ],
   "description": "The proxy wallet address"
  },
  "profileImage": {
   "type": [
    "string",
    "null"
   ],
   "format": "uri",
   "description": "URL to the profile image"
  },
  "verifiedBadge": {
   "type": [
    "boolean",
    "null"
   ],
   "description": "Whether the profile has a verified badge"
  },
  "displayUsernamePublic": {
   "type": [
    "boolean",
    "null"
   ],
   "description": "Whether the username is displayed publicly"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-public-profile-lookup-e90f374f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)
