# Heurist USDC Net Counterparties Forensics Agent

> Heurist USDC Net Counterparties Forensics Agent is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Computes per-counterparty USDC net-flow metrics for a Solana wallet to rank net payers and receivers and reveal flow asymmetries

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/BaseUSDCForensicsAgent/usdc_net_counterparties
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mesh-heurist-xyz-508943f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9s_ebEgKrKckjqp9N5jj6

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 mesh-heurist-xyz-508943f4 -d '<json body>'
```

Example prompt: Can you analyze the USDC counterparty flows for Solana wallet 7xKX...abc — I want to see who the top net payers and receivers are, and whether there are any asymmetries in the flows?

## When to prefer this

Use this endpoint when you need per-counterparty breakdown of USDC flows on Solana — specifically to rank who has been a net payer vs net receiver relative to a wallet. Prefer this over general wallet summaries when the goal is forensic analysis of specific bilateral relationships and asymmetries, not just aggregate in/out totals.

## Known failure modes

- Invalid or malformed wallet address returns a 400 or error response
- Wallet with no USDC transaction history returns empty or zero-value results
- Solana RPC or on-chain data unavailability may cause timeouts
- Payment not processed ($0.005 USDC required) results in 402 rejection
- Rate limiting may cause temporary 429 responses

## How this service works

Compute per-counterparty net flow metrics showing whether the wallet is a net payer or receiver for each connected address. Use to rank counterparties by economic importance and spot asymmetric relationships.

## Output

Returns per-counterparty USDC net-flow metrics for the given Solana wallet, including ranked lists of net payers (addresses that have sent more USDC to the wallet than received) and net receivers (addresses that received more than they sent), along with flow asymmetry signals to help identify unusual or one-sided transfer relationships.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 100,
       "description": "Maximum number of counterparties to return (default 100)"
      },
      "address": {
       "type": "string",
       "description": "Wallet address starting with 0x"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mesh-heurist-xyz-508943f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)