{"uid":"cap_YUk4DkgOeW-ap0ZC3__om","slug":"aero-allocator-gauge-allocation-plan-358750fa","name":"Aero Allocator – Gauge Allocation Plan","description":"Ready-to-sign, already-simulated Aero allocate() transaction for an sAERO position: the best split of Base gauges for its size (fees plus incentives, after its own dilution) as unsigned calldata for the Voter, with the cooldown, expected USD per day versus now, and warnings. Handles the contract's rules (full overwrite, exact total, ascending addresses, idle power). Never signs or sends. Base only. Pass ?tokenId=.","url":"https://aeroallocator.app/api/v1/allocate-plan?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["tokenId"],"properties":{"tokenId":{"type":"string","description":"sAERO position id (a whole number). Required."},"maxGauges":{"type":"string","description":"Most gauges the split may use, 1 to 6 (default 6). Fewer gauges means fewer entries to sign for."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K1mWz06OUQ0FZTHA6QcTK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an optimized, ready-to-sign allocate() calldata plan for an sAERO voting position on Base, splitting votes across the best gauges by expected yield.","exampleAgentPrompt":"Can you work out the best gauge allocation plan for my sAERO position with token ID 4821, using at most 4 gauges, and show me the unsigned calldata I'd need to sign plus how much I'd earn per day?","exampleUseCases":[{"title":"Maximize sAERO gauge yield","prompt":"I have sAERO position token ID 7302 — what's the optimal way to split my votes across gauges right now to maximize my daily USD earnings? Give me the ready-to-sign calldata."},{"title":"Check reallocation before cooldown expires","prompt":"Before I try to reallocate my sAERO token 2201, can you tell me if I'm past the cooldown period and what warnings I should know about, along with the best gauge split for it?"},{"title":"Simplified plan with fewer gauges","prompt":"Give me a simple gauge allocation plan for my sAERO position 9540 using no more than 3 gauges — I want to minimize the number of entries I have to sign for while still getting a good yield."}],"resultDescription":"Returns unsigned calldata ready to submit to the Aerodrome Voter contract for the allocate() function, along with: the optimal split of Base gauges (addresses and weights in ascending address order, summing to exact total), the expected USD earned per day versus the current allocation, the cooldown period remaining, and any warnings about idle voting power or contract rule violations. Does not sign or broadcast the transaction.","failureModes":["Invalid or non-existent tokenId returns an error indicating the position was not found","Position in cooldown period returns a warning with time remaining before reallocation is allowed","tokenId not an sAERO position on Base returns a domain validation error","maxGauges out of range (not 1–6) returns a parameter validation error","On-chain RPC unavailability causes a 503 or timeout error","Position with zero voting power returns a warning about idle power with no allocation plan"],"whenToPreferThis":"Use this endpoint when you need an optimized, contract-compliant, ready-to-sign allocation plan for an Aerodrome sAERO position on Base — especially when you want the fees-plus-incentives yield calculation with dilution factored in, cooldown awareness, and calldata that satisfies the Voter contract's strict rules (full overwrite, ascending addresses, exact total). Prefer this over manual gauge research or generic DeFi analytics when the goal is actionable, simulation-backed calldata rather than raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:36:03.601Z","isFirstParty":false,"canonicalSlug":"aero-allocator-gauge-allocation-plan-358750fa"}