{"uid":"cap_8FOy8uXrJcU5_eaGpYL5L","slug":"aero-allocator-saero-position-status-ccedb84c","name":"Aero Allocator – sAERO Position Status","description":"Where an Aero sAERO position stands on Base: its voting power and lock, how much is idle or allocated to gauges, when it can next be re-allocated (the wait after any allocation, 47 hours at launch), what it earns per day now versus the best split of gauges for its own size (fees plus incentives, after its own dilution), and a stay / switch / allocate recommendation. Pass ?tokenId= or ?address=. Read-only.","url":"https://aeroallocator.app/api/v1/position?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","properties":{"address":{"type":"string","description":"0x… wallet address holding sAERO positions (the first 10 are analysed). Pass this or tokenId, not both."},"tokenId":{"type":"string","description":"sAERO position id (a whole number). Pass this or address, not both."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_ut5JoqhpPp2grZCIqR-UN","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":"Returns voting power, lock status, idle vs allocated amounts, reallocation cooldown, daily earnings, optimal gauge split, and a stay/switch/allocate recommendation for an sAERO position on Base.","exampleAgentPrompt":"Check my sAERO position for token ID 4821 on Base — tell me how much is idle vs allocated to gauges, when I can reallocate, what it's earning per day right now, and whether I should stay or switch to a better gauge split.","exampleUseCases":[{"title":"Daily yield optimization check","prompt":"Look up my sAERO position at token ID 7340 and tell me if my current gauge allocation is optimal — what am I earning per day now versus what I could earn with the best split, and should I reallocate?"},{"title":"Reallocation cooldown check","prompt":"I want to move my sAERO position (token ID 2215) to different gauges — can you check if the 47-hour cooldown has passed and when I'm eligible to reallocate?"},{"title":"Portfolio overview by wallet","prompt":"Check all my sAERO positions under wallet 0x3fA8B653F9abf91428800C9f7e98cD867b86A7d1 and summarize the voting power, how much is idle, and whether any positions need reallocation."}],"resultDescription":"Returns a JSON object containing the sAERO position's voting power, lock details, idle and gauge-allocated amounts, reallocation eligibility and cooldown timestamp, current daily fee and incentive earnings, projected daily earnings from the optimal gauge split (after dilution), and an actionable stay/switch/allocate recommendation.","failureModes":["Missing both tokenId and address parameters returns an error","Providing both tokenId and address simultaneously is rejected","Invalid tokenId (non-numeric or non-existent) returns a not-found error","Invalid address format returns a validation error","If no sAERO positions exist for the given address, returns empty results","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a read-only, holistic snapshot of an sAERO position's status on Base — especially when deciding whether to reallocate gauges. It uniquely combines voting power, cooldown eligibility, current vs optimal earnings, and an explicit recommendation in one call. Prefer it over generic on-chain queries when you want pre-computed optimization analysis rather than raw contract data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:58.253Z","isFirstParty":false,"canonicalSlug":"aero-allocator-saero-position-status-ccedb84c"}