Sum costBreakdown.subtotal and costBreakdown.taxesTotal across orders to reconcile against payout reports.
Watch for the voided* cost-breakdown fields (e.g. voidedPrice, voidedTaxesTotal) which represent refunded/cancelled amounts.
Use the orders connection's totalCount and a nodes(limit: ...) argument to page through large order lists instead of requesting every order in a single query.
Known gotchas
Voided amounts are returned as separate fields alongside the live totals rather than being netted out automatically — your aggregation logic has to subtract them yourself.
Because the GraphQL API is labeled beta, verify exact costBreakdown field names against the live GraphiQL Explorer schema before building financial-reconciliation reports on top of them — field availability isn't guaranteed stable release over release.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?