# premiumrewards.vip Entity Lookup

> premiumrewards.vip Entity Lookup is a paid API for AI agents from api.premiumrewards.vip, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Paid HTTP GET lookup for entity data, returning plain text results for a given query ID, priced at $0.01 USDC per call via x402 protocol.

## Facts

- Endpoint: GET https://api.premiumrewards.vip/entity?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/premiumrewards-vip-entity-lookup-88517820
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qyebB0_krmAYr8j0dWFSv

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 premiumrewards-vip-entity-lookup-88517820
```

Example prompt: Look up entity information using query ID 'abc123' on premiumrewards.vip — it costs $0.01 USDC per lookup via x402 on Base.

## When to prefer this

Use this endpoint when you need to perform a paid entity lookup by query ID and are operating in an x402-compatible agent environment that can handle USDC micropayments on Base. It is appropriate for single-record, low-cost ($0.01) entity resolution tasks where plain text output is sufficient.

## Known failure modes

- HTTP 402 returned if payment is not included or fails — agent must complete x402 USDC payment on Base before receiving data
- Missing or invalid qid parameter may result in empty or error response
- Network errors or service unavailability on api.premiumrewards.vip
- Insufficient USDC balance on Base for micropayment

## How this service works

Four paid HTTP lookups. USDC on Base. Unpaid GET returns 402.

## Output

A plain text response containing entity data corresponding to the provided query ID (qid). Returns HTTP 402 Payment Required if payment has not been made via the x402 protocol on Base USDC.

## 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": [],
     "properties": {
      "qid": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "text/plain"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "text/plain"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/premiumrewards-vip-entity-lookup-88517820/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.premiumrewards.vip](https://www.zero.xyz/host/api.premiumrewards.vip/llms.txt)