# Onvexia Labelled Address Lookup

> Onvexia Labelled Address Lookup is a paid API for AI agents from onvexia.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-17).

Returns labelled blockchain addresses filtered by chain, entity, and category (exchange, bridge, DEX, MEV, staking, mining, sanctioned)

## Facts

- Endpoint: GET https://onvexia.com/v1/labels
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onvexia-labelled-address-lookup-0ce03271
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZbHJR_RmHrbAqWELyHbxZ

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 onvexia-labelled-address-lookup-0ce03271
```

Example prompt: Pull all Onvexia-labelled sanctioned addresses on Ethereum, up to 500 results, so I can screen them for compliance.

## When to prefer this

Use this endpoint when you need to look up or filter known blockchain address labels by entity name, category (exchange, bridge, DEX, MEV, staking, mining, sanctioned), or chain. Prefer it over generic on-chain data providers when you need pre-classified, entity-resolved labels with provenance metadata rather than raw transaction data. Particularly suited for compliance, forensic, or analytics workflows where knowing who controls an address matters more than raw balance or transaction history.

## Known failure modes

- Invalid chain identifier returns empty data array
- Unsupported category enum value may return no results or an error
- Limit exceeding 500 may be rejected or capped
- Payment failure (402) if x402 USDC micropayment is not fulfilled
- No label held for a given address returns empty array, not an error
- Rate limiting if too many requests are made in rapid succession

## How this service works

Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.

## Output

A JSON object containing a `data` array of labelled address records (address, entity name, category, chain) and a `meta` object with coverage and provenance information including a link to the OpenAPI docs. An empty array means no matching labels are held, not that the addresses are unknown or safe.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string"
      },
      "limit": {
       "type": "string",
       "description": "Max 500"
      },
      "entity": {
       "type": "string"
      },
      "category": {
       "type": "string",
       "description": "exchange|bridge|dex|mev|staking|mining|sanctioned"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "description": "The result — an array or object depending on the endpoint. An empty array means no rows in range, never that the metric is unsupported."
      },
      "meta": {
       "type": "object",
       "description": "Coverage and provenance: what was measured, and what is not held. A null label means no label is held, never that the subject is safe."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "meta": {
   "docs": "https://onvexia.com/openapi.json",
   "endpoint": "/v1/labels"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-labelled-address-lookup-0ce03271/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onvexia.com](https://www.zero.xyz/host/onvexia.com/llms.txt)