{"uid":"cap__yoObpEhNbHbFm0dnGEX4","slug":"depin-rewards-earnings-trend-53cff47f","name":"DePIN Rewards & Earnings Trend","description":"Reward economics and earnings trend for a DePIN entity or subnetwork. Give network (helium) with an entity key or a subnetwork (iot, mobile). This is a keyed enrichment: without the Relay key configured it returns available false with a note; the keyless network, hotspot and wallet routes do not need it.","url":"https://payai.agentstools.dev/depin/rewards","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"key":{"type":"string","description":"Optional hotspot entity or asset key (base58)"},"days":{"type":"integer","description":"Lookback window in days (default 7, max 30)"},"network":{"enum":["helium"],"type":"string","description":"DePIN network id (default helium)"},"subnetwork":{"enum":["iot","mobile"],"type":"string","description":"Optional subnetwork (default mobile)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_G28DuE2IEuY_xQwmtY3Sz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns reward economics and earnings trend data for a DePIN entity or subnetwork (e.g. Helium hotspot, IoT, or Mobile subnetwork)","exampleAgentPrompt":"Can you pull the reward economics and 14-day earnings trend for my Helium hotspot with entity key 11abc123XYZ... on the mobile subnetwork?","exampleUseCases":[{"title":"Hotspot operator earnings review","prompt":"Look up the reward trend for my Helium hotspot — its entity key is 11Hk7QZ3abc — over the last 30 days on the IoT subnetwork. I want to see if earnings have gone up or down."},{"title":"Subnetwork-level reward analysis","prompt":"What are the current reward economics and earnings trend for the Helium mobile subnetwork over the past 7 days? I'm trying to understand how the whole network is performing."},{"title":"DePIN portfolio earnings monitoring","prompt":"Check the DePIN reward stats on the Helium network for the IoT subnetwork over the last 14 days — I want the trend so I can track whether yields are improving this month."}],"resultDescription":"Returns reward economics data including current reward amounts, earnings trend over the specified lookback window, and subnetwork classification. If a Relay key is not configured, returns available: false with an explanatory note. Keyless routes (network, hotspot, wallet) do not require the key.","failureModes":["Missing Relay key for keyed enrichment routes returns available: false with a note rather than an error","Invalid or unrecognized entity key (base58) may return empty or null reward data","Lookback window exceeding 30 days is not supported; defaults or errors expected","Unsupported network values (non-helium) will be rejected by enum validation","Network connectivity issues or upstream Helium API unavailability may cause failures"],"whenToPreferThis":"Choose this endpoint when you need DePIN-specific reward economics and earnings trend data for the Helium network, including hotspot-level, wallet-level, or subnetwork-level (IoT/mobile) reward analysis. It is especially useful for monitoring earnings over time rather than just a point-in-time balance. Prefer it over generic blockchain balance APIs when you need trend context and DePIN-specific metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:09.590Z","isFirstParty":false}