# Onvexia Capital Flow Graph

> Onvexia Capital Flow Graph 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 a graph of capital flow edges showing which source addresses or entities are funding a given blockchain asset, with provenance metadata.

## Facts

- Endpoint: GET https://onvexia.com/v1/graph/capital-flow
- 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-capital-flow-graph-aec827d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M7XM2rCiEPCw8cAsKEOic

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-capital-flow-graph-aec827d0
```

Example prompt: Show me the top 8 capital flow sources feeding into Ethereum's USDC contract — I want to see which wallets or entities are driving the largest inflows, with provenance details.

## When to prefer this

Choose this endpoint when you need to trace the on-chain funding graph for a specific asset — identifying which source addresses or entities are driving capital inflows. It is especially valuable for DeFi risk analysis, due diligence on new tokens, or counterparty exposure checks. Prefer it over general block explorers when you need labelled addresses, multi-chain coverage, and fused provenance metadata in a single structured response.

## Known failure modes

- Empty data array returned when no capital flow data exists for the queried asset (not an error — check meta for coverage)
- 402 Payment Required if USDC micropayment via x402 is missing or insufficient
- Invalid or unsupported asset/chain identifier returns an error or empty result
- Null labels in meta indicate no label is held, not that the address is safe
- Rate limiting or network errors returning 429 or 5xx

## 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 with a `data` array of source-to-asset capital flow edges (up to the requested limit, default 8) and a `meta` object describing coverage, measurement scope, and provenance — including a link to the full OpenAPI spec. An empty data array means no flow rows exist in range, not that the metric is unsupported.

## 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": {
      "limit": {
       "type": "string",
       "description": "Max source->asset edges, default 8"
      }
     }
    }
   },
   "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/graph/capital-flow"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-capital-flow-graph-aec827d0/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)