Tool detail

Agent Mercantile

Returns a bounded snapshot of up to 40 Ethereum/Base token holdings for one address, with overflow flags, partial DEX pricing coverage and an evidence-readiness summary.

Categories: Wallet analytics, Onchain data

Use when

check whether wallet-holdings evidence is complete enough before reasoning about it
get a bounded inventory snapshot of an Ethereum/Base wallet's top holdings

Not for

not complete portfolio enumeration -- capped at 40 holdings, check overflow_holding_count
not net worth, investment advice, or transaction approval

Inputs

POST JSON body: { address: string (required) }; chains (array, optional, default eip155:1+8453), declared_holdings (array, optional, <=10).

Admitted input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "One public 0x-prefixed 20-byte EVM address."
    },
    "chains": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096,
        "enum": [
          "eip155:1",
          "eip155:8453"
        ]
      },
      "minItems": 1,
      "maxItems": 2,
      "description": "Optional. Defaults to Ethereum and Base."
    },
    "declared_holdings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "enum": [
              "eip155:1",
              "eip155:8453"
            ]
          },
          "quantity_raw": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "description": "uint256 decimal integer string. Hint only."
          },
          "token": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "description": "Nonzero ERC-20 contract."
          }
        },
        "required": [
          "chain",
          "token",
          "quantity_raw"
        ],
        "additionalProperties": false
      },
      "minItems": 0,
      "maxItems": 10
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Endpoint

Method: POST
URL: https://api.agentmercantile.com/v1/portfolio-preflight

Payment

Protocol: x402
Listed price: 0.01 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: POST https://api.agentmercantile.com/v1/portfolio-preflight
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z