{"uid":"cap_VKsANJbdgUFoijEozybLj","slug":"brainiac-token-vesting-schedule-audit-38bf3921","name":"BRAINIAC Token Vesting Schedule Audit","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/tokenomics/token-vesting-schedule-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"supply":{"type":"string"},"allocations":{"type":"array","items":{"type":"object","required":["id","beneficiary","amount","model"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"model":{"enum":["linear","custom"],"type":"string"},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"amount":{"type":"string"},"unlocks":{"type":"array","items":{"type":"object","required":["at","amount"],"properties":{"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"amount":{"type":"string"}},"additionalProperties":false},"maxItems":64},"cliffDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"cliffMode":{"enum":["included","before_vesting"],"type":"string"},"beneficiary":{"type":"string","maxLength":80,"minLength":1},"initialUnlockAmount":{"type":"string"},"cliffDurationSeconds":{"type":"integer","maximum":3153600000,"minimum":0},"initialUnlockPercent":{"type":"string","pattern":"^(100(?:\\.0{1,4})?|(?:0|[1-9]\\d?)(?:\\.\\d{1,4})?)$"},"unlockFrequencySeconds":{"type":"integer","maximum":3153600000,"minimum":1},"vestingDurationSeconds":{"type":"integer","maximum":3153600000,"minimum":1}},"additionalProperties":false},"maxItems":40,"minItems":1},"distributions":{"type":"array","items":{"type":"object","required":["allocationId","amount","at"],"properties":{"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"amount":{"type":"string"},"beneficiary":{"type":"string","maxLength":80,"minLength":1},"allocationId":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":100},"evaluationDates":{"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"maxItems":12}}},"responseSchema":{"type":"json","example":{"warnings":[{"code":"duplicate_beneficiary","detail":"Beneficiary 0x1111111111111111111111111111111111111111 has allocations team, team-bonus."},{"code":"overlapping_schedule","detail":"Allocations team and team-bonus cover overlapping times."}],"limitations":["Only the supply, allocations, and distribution records in this request were audited. No wallet balance or token transfer was read.","Timestamps are UTC instants and must end in Z. No timezone is applied.","Amounts are integers in the caller's smallest unit. An initial unlock percent uses integer division, and any remainder stays in the vesting amount.","allocation_percentage is truncated to 4 decimal places.","A linear schedule releases the initial unlock at the start. cliffMode before_vesting places later unlocks one frequency apart after the cliff. cliffMode included starts the clock at the start and withholds vesting unlocks that fall before the cliff until the cliff.","When the vesting duration is not a multiple of the unlock frequency, the last unlock is at the vesting end and receives the remaining tokens. Earlier unlocks are equal integer shares.","The last unlock includes any remainder from integer division, so a complete schedule adds up to the allocation amount.","A custom allocation uses only its unlock list. Linear fields on a custom allocation are not used, and a custom unlock list on a linear allocation is not used.","A distribution is compared only when its allocationId matches an allocation in this request.","Allocations with missing parameters are counted in the supply totals and omitted from the unlock schedule."],"audit_status":"warnings","total_allocated":"700000","unlock_schedule":[{"at":"2026-02-01T00:00:00.000Z","kind":"unlock","amount":"50000","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team-bonus","cumulative_amount":"50000","cumulative_issuance":"50000"},{"at":"2026-03-01T00:00:00.000Z","kind":"unlock","amount":"50000","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team-bonus","cumulative_amount":"100000","cumulative_issuance":"100000"},{"at":"2026-03-02T00:00:00.000Z","kind":"unlock","amount":"200000","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team","cumulative_amount":"200000","cumulative_issuance":"300000"},{"at":"2026-04-01T00:00:00.000Z","kind":"unlock","amount":"200000","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team","cumulative_amount":"400000","cumulative_issuance":"500000"},{"at":"2026-04-01T00:00:00.000Z","kind":"evaluation","amount":"500000","cumulative_issuance":"500000"},{"at":"2026-05-01T00:00:00.000Z","kind":"unlock","amount":"200000","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team","cumulative_amount":"600000","cumulative_issuance":"700000"}],"unallocated_supply":"300000","beneficiary_findings":[{"code":"duplicate_beneficiary","detail":"Beneficiary 0x1111111111111111111111111111111111111111 has allocations team, team-bonus.","severity":"medium","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team"},{"code":"overlapping_schedule","detail":"Allocations team and team-bonus cover overlapping times.","severity":"medium","beneficiary":"0x1111111111111111111111111111111111111111","allocation_id":"team"}],"allocation_percentage":"70.0000","distribution_mismatches":[{"at":"2026-04-01T00:00:00.000Z","code":"distributed_below_unlocked","detail":"Allocation team had 100000 distributed and 400000 unlocked at 2026-04-01T00:00:00.000Z.","allocation_id":"team","expected_amount":"400000","distributed_amount":"100000"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dUW58SQlsln8YAAk_dKys","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits a token vesting schedule by validating allocations, unlock timelines, cliff logic, distributions, and supply totals, returning warnings and a full unlock schedule.","exampleAgentPrompt":"Audit my token vesting schedule: total supply is 1,000,000 tokens. I have two allocations — 'team' for address 0xAAA with 500,000 tokens using a linear model starting 2025-01-01T00:00:00Z, a 12-month cliff (cliffMode: before_vesting), 24-month vesting, monthly unlock frequency, and no initial unlock; and 'investors' for 0xBBB with 200,000 tokens using a linear model starting 2025-01-01T00:00:00Z, 6-month cliff (cliffMode: included), 18-month vesting, monthly unlocks, and 10% initial unlock. Tell me if there are any warnings, overlapping schedules, or supply mismatches.","exampleUseCases":[{"title":"Pre-launch tokenomics compliance check","prompt":"Before we launch, audit our token vesting plan: total supply 10,000,000 tokens, with three allocations — 'founders' (0xF01, 3,000,000 tokens, linear, start 2025-06-01T00:00:00Z, 12-month cliff using before_vesting, 48-month vesting, monthly unlocks, 0% initial unlock), 'advisors' (0xA01, 500,000 tokens, linear, start 2025-06-01T00:00:00Z, 6-month cliff using included, 24-month vesting, monthly unlocks, 5% initial unlock), and 'ecosystem' (0xE01, 2,000,000 tokens, linear, start 2025-06-01T00:00:00Z, no cliff, 36-month vesting, monthly unlocks). Flag any warnings or inconsistencies."},{"title":"Duplicate beneficiary detection","prompt":"Check my vesting schedule for duplicate or overlapping beneficiaries: supply is 5,000,000 tokens, with allocations 'team' (0x1111111111111111111111111111111111111111, 1,000,000 tokens, linear, start 2026-01-01T00:00:00Z, 12-month cliff before_vesting, 36-month vesting, monthly unlocks) and 'team-bonus' (0x1111111111111111111111111111111111111111, 200,000 tokens, linear, start 2026-01-01T00:00:00Z, no cliff, 12-month vesting, monthly unlocks). I want to know if there are any duplicate beneficiary warnings."},{"title":"Custom unlock schedule validation","prompt":"Validate a custom vesting schedule for our private sale: supply 2,000,000 tokens, one allocation 'private-sale' for 0xSALE1 with 800,000 tokens using a custom model, with unlocks at 2025-09-01T00:00:00Z (200,000), 2026-03-01T00:00:00Z (200,000), 2026-09-01T00:00:00Z (200,000), and 2027-03-01T00:00:00Z (200,000). Evaluate at dates 2025-09-01T00:00:00Z and 2026-03-01T00:00:00Z to show cumulative issuance."}],"resultDescription":"Returns a JSON object with: audit_status ('pass', 'warnings', or 'fail'), an array of warnings (each with a code and detail), a computed unlock_schedule listing every unlock event with timestamp, amount, beneficiary, allocation ID, and cumulative amounts, total_allocated sum across all allocations, and a limitations array explaining computation assumptions and rounding behavior.","failureModes":["Missing required allocation fields (id, beneficiary, amount, model) causes the allocation to be omitted from the schedule but still counted in supply totals","Amounts that don't sum to the declared supply trigger a supply mismatch warning","Overlapping or duplicate beneficiary schedules produce specific warning codes","Timestamps not in ISO 8601 UTC format (ending in Z) are rejected by schema validation","More than 40 allocations or 100 distributions exceeds schema limits and will cause a validation error","Custom allocations with no unlock list or linear allocations with conflicting custom unlocks may produce incomplete schedules","Integer division rounding on initial unlock percent may leave remainder in vesting amount, noted in limitations"],"whenToPreferThis":"Use this endpoint when you need to programmatically audit or validate a token vesting schedule before or after deployment — especially when checking for supply inconsistencies, duplicate beneficiaries, overlapping timelines, cliff logic errors, or when you need a full computed unlock schedule with cumulative issuance across multiple allocations. It is purpose-built for tokenomics compliance and is more thorough than manual spreadsheet checks. It is not a live on-chain reader — it audits the data you submit, not wallet balances or historical transfers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:42:24.940Z","isFirstParty":false,"canonicalSlug":"brainiac-token-vesting-schedule-audit-38bf3921"}