Machine Spend

Machine Spend reports an agent’s recorded x402 and MPP spend and alerts in one view.

What it includes

total spend and call volume
service-level breakdowns
endpoint-level breakdowns
x402 vs MPP split
count of payments under $0.10
recent x402 and MPP anomaly alerts

Both endpoints take the agent’s SDK key and need the analytics:read scope.

Get a summary

Returns a top-level summary plus recent machine-spend alerts for the authenticated agent.

curl "https://conto.finance/api/sdk/service-spend/summary?period=30d&protocol=all" \
  -H "Authorization: Bearer $CONTO_API_KEY"

Query parameters

Parameter	Type	Default	Description
`period`	string	`30d`	One of `24h`, `7d`, `30d`, `all`
`protocol`	string	`all`	One of `all`, `x402`, `mpp`
`limit`	number	`10`	Recent alerts to return, max 25

Example response

{
  "filters": {
    "period": "30d",
    "protocol": "all",
    "agentId": "cmm5a1agt002n49h7bjqza33r",
    "startDate": "2026-03-18T00:00:00.000Z"
  },
  "summary": {
    "totalSpend": 14.73,
    "totalCalls": 219,
    "activeServices": 6,
    "activeAgents": 1,
    "activeAlerts": 1,
    "micropaymentTransactions": 188,
    "x402Spend": 4.12,
    "x402Calls": 173,
    "mppSpend": 10.61,
    "mppCalls": 46
  },
  "recentAlerts": [
    {
      "protocol": "x402",
      "label": "Price change detected",
      "state": "needs_review",
      "stateLabel": "Needs review",
      "createdAt": "2026-04-16T19:02:11.000Z",
      "organizationName": "Acme",
      "agentName": "research-agent"
    }
  ]
}

List services and endpoints

Returns the top service domains and endpoints for the authenticated agent.

curl "https://conto.finance/api/sdk/service-spend/services?period=7d&protocol=x402&limit=20" \
  -H "Authorization: Bearer $CONTO_API_KEY"

Query parameters

Parameter	Type	Default	Description
`period`	string	`30d`	One of `24h`, `7d`, `30d`, `all`
`protocol`	string	`all`	One of `all`, `x402`, `mpp`
`limit`	number	`10`	Services and endpoints to return, max 50

Example response

{
  "filters": {
    "period": "7d",
    "protocol": "x402",
    "agentId": "cmm5a1agt002n49h7bjqza33r",
    "startDate": "2026-04-10T00:00:00.000Z"
  },
  "services": [
    {
      "protocol": "x402",
      "serviceDomain": "api.example.com",
      "totalSpend": 2.41,
      "totalCalls": 120,
      "avgPricePerCall": 0.0201,
      "minPricePerCall": 0.01,
      "maxPricePerCall": 0.05,
      "firstActivityAt": "2026-04-11T03:44:52.000Z",
      "lastActivityAt": "2026-04-16T21:08:17.000Z"
    }
  ],
  "endpoints": [
    {
      "protocol": "x402",
      "resourceUrl": "https://api.example.com/search",
      "serviceDomain": "api.example.com",
      "totalSpend": 1.84,
      "totalCalls": 92,
      "avgPricePerCall": 0.02,
      "lastActivityAt": "2026-04-16T21:08:17.000Z"
    }
  ]
}

Anomaly alerts

Conto runs these checks each time an x402 or MPP payment is recorded. Thresholds are fixed.

Alert	Raised when
Price spike	A payment is more than 50% above the agent’s average for that service, after 5 or more calls
High frequency	The agent records more than 60 paid calls in 5 minutes
New service	The agent pays a service for the first time
Budget burn	At the current rate, today’s spend will pass 90% of the wallet’s daily limit

Budget burn needs a daily limit on the wallet. Alerts appear in Alerts & Approvals in the dashboard and in recentAlerts from the summary endpoint.

When to use Machine Spend vs protocol-specific endpoints

Use Machine Spend for a unified service view across both protocols. Use protocol-specific endpoints for details unique to one rail:

/api/sdk/x402/services for x402 service-specific stats
/api/sdk/x402/budget for x402 burn rate and policy limit views
/api/sdk/mpp/services for MPP service-specific stats
/api/sdk/mpp/budget for MPP session and budget views

Dashboard view

The Machine Spend page in the dashboard shows the same data:

filter by protocol and time window
compare top services and endpoints
compare top agents
review recent x402 and MPP anomaly alerts

Get started

Integrate

Payments

Conto Commerce

Spending controls

Operate

Conto Pay

Machine Spend

What it includes

Get a summary

Query parameters

Example response

List services and endpoints

Query parameters

Example response

Anomaly alerts

When to use Machine Spend vs protocol-specific endpoints

Dashboard view

​What it includes

​Get a summary

​Query parameters

​Example response

​List services and endpoints

​Query parameters

​Example response

​Anomaly alerts

​When to use Machine Spend vs protocol-specific endpoints

​Dashboard view

What it includes

Get a summary

Query parameters

Example response

List services and endpoints

Query parameters

Example response

Anomaly alerts

When to use Machine Spend vs protocol-specific endpoints

Dashboard view