{"uid":"cap_Jq1qqWHADJuVVvlmd4b2T","slug":"signalharness-agent-trace-cost-report-from-supplied-usage-458e9ef9","name":"SignalHarness Agent Trace Cost Report from Supplied Usage","description":"Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.","url":"https://signalharness.ai/api/agent/services/agent_trace_cost_report_from_supplied_usage/invoke","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"request_json":{"type":"string","maxLength":65536,"minLength":2}}},"responseSchema":{"type":"json","example":{"replay":false,"result":{"warnings":["Verify the caller-supplied data before relying on this result."],"service_id":"agent_trace_cost_report_from_supplied_usage","analysis_json":"{\"example\":\"schema-valid caller-supplied data\"}","evidence_scope":"caller_supplied_data"},"status":"succeeded","receipt":{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","usage":[],"status":"succeeded","network":"eip155:8453","artifacts":[],"endedAtMs":0,"latencyMs":0,"paymentId":"example-payment","receiptId":"example-receipt","requestId":"example-request","serviceId":"agent_trace_cost_report_from_supplied_usage","executionId":"example-execution","startedAtMs":0,"amountAtomic":"25000","resultSha256":"3510f2ad8ae3c7a2b5808c1953864a2d6227aabaa6208c3944066aa66c256619","serviceVersion":"1.0.0","settlementReference":"0x0000000000000000000000000000000000000000000000000000000000000000"},"artifacts":[],"requestId":"example-request","executionId":"example-execution"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rUjs9NaADjuSji0rCBUtl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a cost analysis report for an AI agent trace by processing caller-supplied usage data and returning a structured analysis with warnings about data provenance.","exampleAgentPrompt":"Can you generate a cost analysis report for my agent trace using this usage data I collected: {\"model\":\"gpt-4o\",\"input_tokens\":1500,\"output_tokens\":400,\"calls\":3}? I want to see the full breakdown and any warnings about the data.","exampleUseCases":[{"title":"Audit agent session spending","prompt":"I ran an agent session and collected my own usage logs. Here's the usage JSON: {\"calls\":12,\"tokens_in\":8000,\"tokens_out\":2200,\"services_called\":[\"search\",\"summarize\"]}. Can you run a cost report on this and tell me what it would have cost?"},{"title":"Validate cost estimate before deployment","prompt":"Before I deploy my agent pipeline, I want to estimate costs. Here's a sample usage trace I mocked up: {\"agent_steps\":5,\"tool_calls\":8,\"input_tokens\":3000,\"output_tokens\":900}. Can you generate a cost report from this so I can check if the numbers look right?"},{"title":"Debug unexpected agent billing","prompt":"My agent run produced this usage record and I'm not sure the billing matches what I expected: {\"api_calls\":20,\"model\":\"claude-3-opus\",\"tokens\":15000}. Can you analyze this usage data and give me a cost breakdown report with any warnings?"}],"resultDescription":"Returns a JSON result containing a cost analysis under `analysis_json`, a list of warnings (notably that caller-supplied data should be verified), the `service_id` of the analyzed service, and an `evidence_scope` field indicating the data came from the caller. Also includes a receipt with payment details, network info (Base/eip155:8453), amount charged in atomic USDC units, and execution metadata.","failureModes":["Invalid or malformed JSON string in request_json field causes rejection","Input JSON string exceeds 65536 character limit","Submitted usage data does not conform to expected schema, triggering validation warnings","Payment failure on x402 protocol results in 402 response with no analysis","Empty or too-short request_json (minLength 2) rejected","Result includes warning that caller-supplied data may not be trustworthy — analysis is only as good as the input"],"whenToPreferThis":"Choose this endpoint when you have your own agent usage data or trace logs and want a structured cost report computed against them — especially useful when you cannot rely on server-side telemetry and need to submit usage records yourself. It is ideal for cost estimation, billing audits, and pre-deployment checks where the agent operator controls the input data. Not suitable when you need server-verified usage data or real-time live trace capture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:11:16.041Z","isFirstParty":false}