{
  "info": {
    "name": "InsumerAPI",
    "description": "On-chain verification API. 26 endpoints across 33 blockchains. ECDSA-signed responses. Docs: https://insumermodel.com/developers/",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-API-Key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Key Discovery",
      "item": [
        {
          "name": "Get JWKS Public Key Set",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/jwks",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "jwks"]
            },
            "description": "Get JWKS public key set. No auth required."
          }
        },
        {
          "name": "List Compliance Templates",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/compliance/templates",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "compliance", "templates"]
            },
            "description": "List pre-configured compliance templates (Coinbase KYC, Gitcoin Passport). No auth required."
          }
        }
      ]
    },
    {
      "name": "On-Chain Verification",
      "item": [
        {
          "name": "Attest On-Chain Conditions",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n  \"conditions\": [\n    {\n      \"type\": \"token_balance\",\n      \"contractAddress\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n      \"chainId\": 1,\n      \"threshold\": 1000,\n      \"decimals\": 6,\n      \"label\": \"USDC >= 1000\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/attest",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "attest"]
            },
            "description": "Verify 1-10 on-chain conditions. Returns ECDSA-signed booleans. 1 credit (2 with Merkle proofs)."
          }
        },
        {
          "name": "Wallet Trust Profile",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/trust",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "trust"]
            },
            "description": "Wallet trust fact profile. 36 checks across 4 dimensions (USDC and USDT). 3 credits (6 with Merkle)."
          }
        },
        {
          "name": "Batch Wallet Trust Profiles",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallets\": [\n    { \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\" },\n    { \"wallet\": \"0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B\" }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/trust/batch",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "trust", "batch"]
            },
            "description": "Batch wallet trust profiles. Up to 10 wallets, 5-8x faster. 3 credits/wallet."
          }
        }
      ]
    },
    {
      "name": "Credits",
      "item": [
        {
          "name": "Check Credit Balance",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/credits",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "credits"]
            },
            "description": "Check API credit balance."
          }
        },
        {
          "name": "Buy API Credits",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"txHash\": \"0x...\",\n  \"chainId\": 8453,\n  \"amount\": 5,\n  \"updateWallet\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/credits/buy",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "credits", "buy"]
            },
            "description": "Buy API credits with USDC. Volume discounts: $5–$99 = 25 credits/$1 ($0.04/call), $100–$499 = 33/$1 ($0.03), $500+ = 50/$1 ($0.02). Supported chains: Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana. Non-refundable. First purchase registers sender wallet; subsequent purchases must match. Set updateWallet: true to change registered wallet (verified transfer proves ownership)."
          }
        },
        {
          "name": "Buy API Key with USDC",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"txHash\": \"0x...\",\n  \"chainId\": 8453,\n  \"amount\": 5,\n  \"appName\": \"my-agent\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/keys/buy",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "keys", "buy"]
            },
            "description": "Buy a new API key with USDC. No auth required. Send USDC to the platform wallet, then provide the tx hash to get a key. One key per wallet address. Use POST /v1/credits/buy to top up existing keys."
          }
        }
      ]
    },
    {
      "name": "Merchant Directory",
      "item": [
        {
          "name": "List Merchants",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/merchants?token=&verified=",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants"],
              "query": [
                {
                  "key": "token",
                  "value": "",
                  "description": "Filter by token symbol (optional)"
                },
                {
                  "key": "verified",
                  "value": "",
                  "description": "Filter by verification status (optional, boolean)"
                }
              ]
            },
            "description": "List merchants. Optional query params: token, verified."
          }
        },
        {
          "name": "Get Merchant Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Get merchant details with tier structures."
          }
        },
        {
          "name": "Token and NFT Registry",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tokens?chain=&symbol=&type=",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tokens"],
              "query": [
                {
                  "key": "chain",
                  "value": "",
                  "description": "Filter by chain (optional)"
                },
                {
                  "key": "symbol",
                  "value": "",
                  "description": "Filter by token symbol (optional)"
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "Filter by type (optional)"
                }
              ]
            },
            "description": "Token and NFT registry. Optional query params: chain, symbol, type."
          }
        }
      ]
    },
    {
      "name": "Discount Verification",
      "item": [
        {
          "name": "Check Discount Eligibility",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/discount/check?wallet=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&merchant=your-merchant-id&solanaWallet=",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "discount", "check"],
              "query": [
                {
                  "key": "wallet",
                  "value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
                  "description": "EVM wallet address (required)"
                },
                {
                  "key": "merchant",
                  "value": "your-merchant-id",
                  "description": "Merchant ID (required)"
                },
                {
                  "key": "solanaWallet",
                  "value": "",
                  "description": "Solana wallet address (optional)"
                }
              ]
            },
            "description": "Calculate discount for wallet + merchant."
          }
        },
        {
          "name": "Create Signed Discount Code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n  \"merchantId\": \"your-merchant-id\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/verify",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "verify"]
            },
            "description": "Create signed discount code (INSR-XXXXX, valid 30 min). 1 merchant credit."
          }
        },
        {
          "name": "Confirm USDC Payment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"INSR-XXXXX\",\n  \"txHash\": \"0x...\",\n  \"chainId\": 8453\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/payment/confirm",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "payment", "confirm"]
            },
            "description": "Verify USDC payment for discount code."
          }
        }
      ]
    },
    {
      "name": "Commerce Protocols",
      "item": [
        {
          "name": "ACP Discount Eligibility",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n  \"merchantId\": \"your-merchant-id\",\n  \"items\": [\n    { \"path\": \"/items/product-1\", \"amount\": 10000 }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/acp/discount",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "acp", "discount"]
            },
            "description": "ACP (OpenAI/Stripe) format discount eligibility. 1 merchant credit."
          }
        },
        {
          "name": "UCP Discount Eligibility",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"wallet\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n  \"merchantId\": \"your-merchant-id\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/ucp/discount",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ucp", "discount"]
            },
            "description": "UCP (Google) format discount eligibility. 1 merchant credit."
          }
        },
        {
          "name": "Validate Discount Code",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/codes/:code",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "codes", ":code"],
              "variable": [
                {
                  "key": "code",
                  "value": "INSR-XXXXX",
                  "description": "Discount code to validate"
                }
              ]
            },
            "description": "Validate INSR-XXXXX discount code. No auth required."
          }
        }
      ]
    },
    {
      "name": "Merchant Onboarding",
      "item": [
        {
          "name": "Create Merchant",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"companyName\": \"My Store\",\n  \"companyId\": \"my-store\",\n  \"location\": \"New York, NY\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants"]
            },
            "description": "Create merchant (100 free merchant credits)."
          }
        },
        {
          "name": "Request Domain Verification Token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"domain\": \"mystore.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/domain-verification",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "domain-verification"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Request domain verification token."
          }
        },
        {
          "name": "Trigger Domain Verification Check",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/domain-verification",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "domain-verification"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Trigger domain verification check (5/hour limit)."
          }
        },
        {
          "name": "Configure Token Tiers",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ownToken\": {\n    \"symbol\": \"USDC\",\n    \"chainId\": 1,\n    \"contractAddress\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n    \"decimals\": 6,\n    \"tiers\": [\n      { \"name\": \"Bronze\", \"threshold\": 100, \"discount\": 5 },\n      { \"name\": \"Silver\", \"threshold\": 1000, \"discount\": 10 },\n      { \"name\": \"Gold\", \"threshold\": 10000, \"discount\": 15 }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/tokens",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "tokens"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Configure token tiers."
          }
        },
        {
          "name": "Configure NFT Collections",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"nftCollections\": [\n    {\n      \"name\": \"Bored Apes\",\n      \"contractAddress\": \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n      \"chainId\": 1,\n      \"discount\": 20\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/nfts",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "nfts"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Configure NFT collections."
          }
        },
        {
          "name": "Update Merchant Settings",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"discountMode\": \"highest\",\n  \"discountCap\": 25\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/settings",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "settings"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Update discount mode, cap, USDC payments."
          }
        },
        {
          "name": "Buy Merchant Credits",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"txHash\": \"0x...\",\n  \"chainId\": 8453,\n  \"amount\": 5,\n  \"updateWallet\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/credits",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "credits"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Buy merchant verification credits. First purchase registers sender wallet; subsequent purchases must match. Set updateWallet: true to change registered wallet."
          }
        },
        {
          "name": "Publish to Directory",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/directory",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "directory"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Publish merchant to public directory."
          }
        },
        {
          "name": "Get Merchant Status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/merchants/:id/status",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "merchants", ":id", "status"],
              "variable": [
                {
                  "key": "id",
                  "value": "your-merchant-id",
                  "description": "Merchant ID"
                }
              ]
            },
            "description": "Full private merchant details including verification status."
          }
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.insumermodel.com",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "your-api-key-here",
      "type": "string"
    }
  ]
}