Agent Mercantile · Portfolio Preflight

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.agentmercantile.com/v1/portfolio-preflight", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "0x0000000000000000000000000000000000000001",
    "chains": [
      "eip155:1",
      "eip155:8453"
    ]
  }),
});
const data = await res.json();

curl -X POST \
  "https://api.agentmercantile.com/v1/portfolio-preflight" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000000001","chains":["eip155:1","eip155:8453"]}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "address": "0x0000000000000000000000000000000000000001",
  "chain_results": [
    {
      "block_number_observed": "1",
      "chain": "eip155:1",
      "discovery_capped": false,
      "inventory_complete": true,
      "inventory_status": "OK",
      "pages_read": 1,
      "provider_response_complete": true
    }
  ],
  "chains_run": [
    "eip155:1",
    "eip155:8453"
  ],
  "checked_at": "2026-08-21T00:00:00.000Z",
  "concentration": {
    "basis": "PRICED_HOLDINGS_ONLY",
    "concentrated": false,
    "largest_priced_holding": null,
    "largest_priced_share": null,
    "threshold": "0.40"
  },
  "confidence": "MEDIUM",
  "evidence": [
    {
      "id": "e-inv-eip155:1",
      "kind": "inventory",
      "summary": "Bounded native and ERC-20 discovery."
    }
  ],
  "holdings": [
    {
      "asset_kind": "native",
      "balance_adjusted": "0",
      "balance_raw": "0",
      "chain": "eip155:1",
      "confidence": "MEDIUM",
      "decimals": 18,
      "evidence_ids": [
        "e-inv-eip155:1"
      ],
      "liquidity_usd": null,
      "observations": [
        "NO_DEX_MARKET"
      ],
      "pair_address": null,
      "pair_created_at": null,
      "pair_url": null,
      "price_usd": null,
      "priced_usd": null,
      "symbol": "ETH",
      "token": null,
      "volume_h24_usd": null
    }
  ],
  "limitations": [
    "This is a bounded DEX-quoted composition, not guaranteed net worth."
  ],
  "machine": "VM03",
  "methodology_version": "portfolio-preflight-0.1.0",
  "overflow_count_complete": true,
  "overflow_holding_count": 0,
  "requested_chains": [
    "eip155:1",
    "eip155:8453"
  ],
  "returned_holding_count": 1,
  "sources": [
    {
      "block_number": "1",
      "chain": "eip155:1",
      "discovery_capped": false,
      "id": "src-inv-eip155:1",
      "limitations": [],
      "pagination_complete": true,
      "provider": "alchemy",
      "provider_response_complete": true,
      "request_scope": "native+erc20_unknown",
      "retrieved_at": "2026-08-21T00:00:00.000Z",
      "role": "inventory"
    }
  ],
  "status": "OK",
  "valuation": {
    "as_of": "2026-08-21T00:00:00.000Z",
    "priced_holding_count": 0,
    "priced_usd": null,
    "quote_basis": "PARTIAL_DEX_QUOTED_COMPOSITION",
    "unpriced_holding_count": 2
  }
}