{"uid":"cap_o9m3Odinvy6AgrmU8Apro","slug":"aero-allocator-cross-chain-plan-48aec65e","name":"Aero Allocator Cross-Chain Plan","description":"Ordered, ready-to-sign Aero allocate() transactions that spread an sAERO position over gauges on several chains (Base, Ethereum, OP, Arbitrum, Ink, Robinhood, Arc): the best split after each extra chain's ETH cost, or the percentages you give (?chains=5042:30,10:20). Plans from the position's state on every chain, with the ETH to attach, what each step waits for and a simulation of step 1. Never signs or sends. Pass ?tokenId=.","url":"https://aeroallocator.app/api/v1/cross-chain-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":{"days":{"type":"string","description":"Days the one-off ETH fees are weighed against when choosing the best split, 1 to 90 (default: the allocation wait). Ignored when chains is given."},"chains":{"type":"string","description":"Percent of the position per chain other than Base, e.g. 5042:30,10:20 (Arc 30%, OP 20%); Base keeps the rest. Leave out for the best split over all chains."},"tokenId":{"type":"string","description":"sAERO position id (a whole number). Required."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LB0wJLZGN-9WslJvbQL2U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ordered, ready-to-sign sAERO allocate() transactions that optimally spread a position across multiple chains (Base, Ethereum, OP, Arbitrum, Ink, Robinhood, Arc) with ETH cost estimates and step sequencing","exampleAgentPrompt":"Plan the best cross-chain sAERO gauge allocation for my position with token ID 14827 — give me the ordered, ready-to-sign transactions spread across all supported chains optimized for a 30-day fee payoff window.","exampleUseCases":[{"title":"Optimal cross-chain gauge split","prompt":"I want to spread my sAERO position (token ID 14827) optimally across all chains — what's the best allocation split and can you give me the ready-to-sign transactions with ETH amounts I need to attach for each step?"},{"title":"Custom percentage allocation plan","prompt":"Allocate my sAERO position token ID 9412 with 30% going to Arc (chain 5042) and 20% to Optimism (chain 10), letting Base take the rest — give me the ordered transaction steps with what each step waits for."},{"title":"Fee-weighted allocation over short window","prompt":"For sAERO token ID 22301, generate a cross-chain allocation plan weighted against just 7 days of ETH fees so I can see if spreading across chains is worth the cost right now."}],"resultDescription":"An ordered list of ready-to-sign (but unsigned) Aero allocate() transactions covering every chain in the plan, including: the recommended or user-specified percentage split per chain, the ETH value to attach to each transaction, step sequencing dependencies (what each step must wait for), a simulation result for step 1, and a summary of the position's current state across all chains.","failureModes":["Missing or invalid tokenId returns an error — tokenId must be a whole number corresponding to a real sAERO position","Invalid chains format (e.g. malformed chain:percent pairs) returns a parsing error","Token ID that does not exist on any supported chain returns a not-found or empty-state error","Days parameter outside 1–90 range may be rejected or clamped","Network issues fetching on-chain position state across multiple RPC endpoints may cause partial or failed responses","Step 1 simulation failure is surfaced in the response but does not block the plan"],"whenToPreferThis":"Use this endpoint when you need a complete, sequenced, multi-chain sAERO gauge allocation plan without executing anything on-chain. It is the right choice when you want the best automatic chain split or want to specify exact percentages per chain, and need ETH cost estimates and step ordering before committing. Prefer this over single-chain allocation endpoints when the position should be spread across Base, Ethereum, OP, Arbitrum, Ink, Robinhood, or Arc simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:42.202Z","isFirstParty":false,"canonicalSlug":"aero-allocator-cross-chain-plan-48aec65e"}