Insumer Trust Batch

InsumerAPI Batch Wallet Trust Profile

Same curated condition-based access bundle as insumer-trust, but accepts up to 10 wallets in one request (5-8x faster than sequential calls). Each wallet's profile is independently signed; the response supports partial success — failures for one wallet don't fail the rest.

Each wallet's per-dimension attestations retain their original issuer signatures. No orchestrator wrap.

Setup

export INSUMER_API_KEY='insr_live_...'

Reference values

• Endpoint: POST https://api.insumermodel.com/v1/trust/batch
• Cost: 3 credits per successful wallet (6 with proof: "merkle"). Failed wallets in the batch don't cost credits.
• Max wallets per call: 10
• Profile ID format per wallet: TRST-XXXXX

Request shape

wallets is an array of objects, each with a required wallet field plus optional cross-chain wallet fields. (Not an array of plain strings.)

{
  "wallets": [
    { "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" },
    {
      "wallet": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
      "solanaWallet": "5v9CXTpN3WHbM2jAYty88qDGz7P4yuMv8fnuPRXBPmiB"
    }
  ]
}

Top-level proof: "merkle" (optional) applies to all wallets in the batch and costs 6 credits per wallet.

Response shape

{
  "ok": true,
  "data": {
    "results": [
      {
        "trust": {
          "id": "TRST-A1B2C",
          "wallet": "0xd8dA...",
          "conditionSetVersion": "v1",
          "dimensions": { ... },
          "summary": { "totalChecks": 17, "totalPassed": 6, "totalFailed": 11, ... },
          "profiledAt": "2026-...",
          "expiresAt": "2026-..."
        },
        "sig": "...",
        "kid": "insumer-trust-v2"
      },
      {
        "trust": { "id": "TRST-D4E5F", "wallet": "0xAb58...", ... },
        "sig": "...",
        "kid": "insumer-trust-v2"
      }
    ],
    "summary": { "requested": 2, "succeeded": 2, "failed": 0 }
  },
  "meta": {
    "creditsCharged": 6,
    "creditsRemaining": ...
  }
}

Each entry in data.results[] is either a {trust, sig, kid} object or {error: { wallet, message }}. Iterate, branch, and verify each trust independently with insumer-jwks-verify.

Usage

Example 1: Two EVM wallets

curl -X POST https://api.insumermodel.com/v1/trust/batch \
  -H "X-API-Key: $INSUMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      { "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" },
      { "wallet": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B" }
    ]
  }'

Example 2: Mixed cross-chain coverage per wallet

curl -X POST https://api.insumermodel.com/v1/trust/batch \
  -H "X-API-Key: $INSUMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      {
        "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "solanaWallet": "5v9CXTpN3WHbM2jAYty88qDGz7P4yuMv8fnuPRXBPmiB"
      },
      {
        "wallet": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
        "xrplWallet": "rN7n3473SaZBCG4dFL83w7p1W9cgPJqKro",
        "bitcoinWallet": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
      }
    ]
  }'

Example 3: Batch with Merkle proofs

curl -X POST https://api.insumermodel.com/v1/trust/batch \
  -H "X-API-Key: $INSUMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      { "wallet": "0x..." },
      { "wallet": "0x..." }
    ],
    "proof": "merkle"
  }'

Cost: successful_wallets * 6 credits. Reveals raw on-chain balances — only opt in if needed.

When to use batch vs single

Code emission rules

1. Read the API key from an env var. Never inline.
2. Iterate data.results[] and branch on trust vs error. Don't assume every entry succeeded.
3. Verify each profile's signature independently. The batch wrapper does not produce an aggregate signature; each entry in data.results[] carries its own sig and kid.
4. Cap at 10 wallets per call. For larger lists, batch client-side.
5. Pre-validate wallet format before sending. Invalid wallet formats fail validation for the entire request.
6. Backend only. The API key is a backend credential.
7. Don't cache the verdict. Wallet state changes.

Helper script

scripts/trust_batch.py — Python helper. Reads INSUMER_API_KEY from env, accepts a wallet list via --wallets-file (one EVM address per line) or --wallets w1,w2,w3. Builds the proper array-of-objects request body.

python scripts/trust_batch.py --wallets-file allowlist.txt

For per-wallet cross-chain coverage, edit the script's --wallets-file to use JSON-line format (one object per line) or call the API directly with curl.

Error handling

Within a 200 response, individual wallet failures appear as {error: {wallet, message}} entries in data.results[] — those don't consume credits.

Related skills

References

• InsumerAPI OpenAPI spec
• Public JWKS
• Developer docs — trust profile