{"uid":"cap_sTLo1iHtbeip2MleUvUx9","slug":"brainiac-terminal-profitability-api-41f99740","name":"BRAINIAC Terminal Profitability API","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/agent-networks/terminal-profitability?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"terminals":{"type":"array","items":{"type":"object","required":["id","currency"],"properties":{"id":{"type":"string","maxLength":120,"minLength":1},"costs":{"type":"object","properties":{"rent":{"type":"integer","maximum":9007199254740991,"minimum":0},"other":{"type":"integer","maximum":9007199254740991,"minimum":0},"equipment":{"type":"integer","maximum":9007199254740991,"minimum":0},"maintenance":{"type":"integer","maximum":9007199254740991,"minimum":0},"connectivity":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"additionalProperties":false},"maxItems":200,"minItems":1},"transactions":{"type":"array","items":{"type":"object","required":["terminal_id","type_id","count","value"],"properties":{"count":{"type":"integer","maximum":9007199254740991,"minimum":0},"value":{"type":"integer","maximum":9007199254740991,"minimum":0},"type_id":{"type":"string","maxLength":120,"minLength":1},"terminal_id":{"type":"string","maxLength":120,"minLength":1}},"additionalProperties":false},"maxItems":5000},"transaction_types":{"type":"array","items":{"type":"object","required":["id","fee"],"properties":{"id":{"type":"string","maxLength":120,"minLength":1},"fee":{"type":"object","required":["kind"],"properties":{"kind":{"enum":["fixed","percent","tiered"],"type":"string"},"tiers":{"type":"array","items":{"type":"object","properties":{"up_to":{"type":"integer","maximum":9007199254740991,"minimum":0},"amount":{"type":"integer","maximum":9007199254740991,"minimum":0},"rate_bps":{"type":"integer","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":40,"minItems":1},"amount":{"type":"integer","maximum":9007199254740991,"minimum":0},"rate_bps":{"type":"integer","maximum":1000000,"minimum":0}},"additionalProperties":false},"revenue_share_bps":{"type":"integer","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":40,"minItems":1}}},"responseSchema":{"type":"json","example":{"ranking":[{"rank":1,"currency":"EUR","net_profit":600,"terminal_id":"t3"},{"rank":1,"currency":"USD","net_profit":3270,"terminal_id":"t1"},{"rank":2,"currency":"USD","net_profit":40,"terminal_id":"t2"}],"net_profit":[{"amount":3270,"currency":"USD","terminal_id":"t1","break_even_count":4,"profit_margin_bps":9134,"transaction_count":37,"revenue_per_transaction":96},{"amount":40,"currency":"USD","terminal_id":"t2","break_even_count":3,"profit_margin_bps":2500,"transaction_count":4,"revenue_per_transaction":40},{"amount":600,"currency":"EUR","terminal_id":"t3","break_even_count":2,"profit_margin_bps":8000,"transaction_count":10,"revenue_per_transaction":75}],"total_revenue":[{"amount":3580,"currency":"USD","terminal_id":"t1"},{"amount":160,"currency":"USD","terminal_id":"t2"},{"amount":750,"currency":"EUR","terminal_id":"t3"}],"operating_costs":[{"rent":200,"other":10,"total":310,"currency":"USD","equipment":50,"maintenance":20,"terminal_id":"t1","connectivity":30},{"rent":100,"other":0,"total":120,"currency":"USD","equipment":0,"maintenance":0,"terminal_id":"t2","connectivity":20},{"rent":150,"other":0,"total":150,"currency":"EUR","equipment":0,"maintenance":0,"terminal_id":"t3","connectivity":0}],"revenue_by_type":[{"count":20,"value":400000,"revenue":800,"type_id":"cash_in","fee_steps":[{"fee":1000,"step":"fixed","count":20,"amount":50}],"terminal_id":"t1","fee_before_share":1000,"revenue_share_bps":8000},{"count":5,"value":100000,"revenue":1500,"type_id":"bill_pay","fee_steps":[{"fee":1500,"step":"percent","value":100000,"rate_bps":150}],"terminal_id":"t1","fee_before_share":1500,"revenue_share_bps":10000},{"count":12,"value":240000,"revenue":1280,"type_id":"transfer","fee_steps":[{"fee":1000,"step":"tier","count":10,"index":0,"value":200000,"amount":100,"rate_bps":0},{"fee":280,"step":"tier","count":2,"index":1,"value":40000,"amount":40,"rate_bps":50}],"terminal_id":"t1","fee_before_share":1280,"revenue_share_bps":10000},{"count":4,"value":80000,"revenue":160,"type_id":"cash_in","fee_steps":[{"fee":200,"step":"fixed","count":4,"amount":50}],"terminal_id":"t2","fee_before_share":200,"revenue_share_bps":8000},{"count":10,"value":50000,"revenue":750,"type_id":"bill_pay","fee_steps":[{"fee":750,"step":"percent","value":50000,"rate_bps":150}],"terminal_id":"t3","fee_before_share":750,"revenue_share_bps":10000}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TVoB0N0yby1oXo8LLWZB-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates per-terminal profitability, net profit, revenue breakdown by transaction type, and profitability ranking for a fleet of payment terminals","exampleAgentPrompt":"I have three payment terminals — T1 (USD) with rent $200, equipment $50, maintenance $20, connectivity $30, other $10; T2 (USD) with rent $100, connectivity $20; and T3 (EUR) with rent $150 — and I want to know which is most profitable given their transaction histories and fee structures (cash-in at $50 fixed fee, bill-pay at 1.5% of value, transfers tiered). Can you calculate net profit, profit margin, and rank them?","exampleUseCases":[{"title":"ATM network profitability ranking","prompt":"I operate 10 ATMs across two cities. Here are their monthly operating costs and transaction records with our fixed and tiered fee schedules. Which terminals are most profitable and which ones are barely breaking even after costs?"},{"title":"Terminal break-even analysis for new deployment","prompt":"We're evaluating whether to keep running our two new kiosks in USD. I'll give you their cost structures and the first month of transaction data with our percent-based fee schedule — can you tell me their break-even transaction count and current net profit?"},{"title":"Multi-currency terminal revenue comparison","prompt":"I have terminals operating in both USD and EUR. Can you calculate net profit and revenue by transaction type for each one and rank them within their respective currencies, using these cost and transaction inputs?"}],"resultDescription":"Returns a structured JSON object with: a ranked list of terminals by net profit within each currency, net profit details per terminal (amount, profit margin in bps, break-even count, revenue per transaction, total transaction count), total revenue per terminal, itemized operating costs breakdown, and revenue by transaction type including fee calculation steps and revenue share applied.","failureModes":["Missing required fields (terminal id or currency) returns a validation error","Transaction referencing an unknown terminal_id returns an error or is excluded","Malformed fee structure (e.g. tiered fee missing tiers array) causes computation failure","Exceeding maxItems limits (200 terminals, 5000 transactions, 40 transaction types) returns a 400 error","Invalid currency format (not 3 uppercase letters) fails schema validation","Negative or out-of-range integer values for costs or fees fail validation"],"whenToPreferThis":"Use this endpoint when you need to compute profitability, profit margins, break-even analysis, and revenue attribution across a fleet of payment terminals with complex fee structures (fixed, percent, or tiered) and variable operating costs. It is ideal for fintech operators, ATM network managers, or payment kiosk businesses that need per-terminal financial analytics without building their own calculation engine. Prefer this over generic financial APIs when your data includes terminal-level cost centers, revenue share agreements in basis points, and multiple transaction types with distinct fee schedules.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T18:34:26.205Z","isFirstParty":false,"canonicalSlug":"brainiac-terminal-profitability-api-41f99740"}