{"uid":"cap_Tn_-oTbGR5p2SgOlth3Xr","slug":"suverse-time-by-ip-lookup-549dc795","name":"Suverse Time-by-IP Lookup","description":"Current local time for an IP address's location via keyless TimeAPI. Returns ISO date-time, weekday, timezone and DST flag. For agents inferring a user's local time from their IP.","url":"https://proxy.suverse.io/v1/data/suverse-time-by-ip","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/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_xKlm58XsnuypgJj1bLabM","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 the current local time, timezone, weekday, and DST status for a given IP address's geographic location using TimeAPI.","exampleAgentPrompt":"What is the current local time, timezone, and whether daylight saving is active for the IP address 203.0.113.42?","exampleUseCases":[{"title":"Personalize greeting by user's local time","prompt":"A user just connected from IP 198.51.100.77 — what's their current local time and timezone so I can show them a good morning or good evening greeting?"},{"title":"Schedule reminder in user's local timezone","prompt":"I need to send a reminder to a user whose IP is 203.0.113.15 — can you find out their local time and timezone so I can schedule it correctly for 9am their time?"},{"title":"Audit log timestamp localization","prompt":"We have an event logged from IP 185.220.101.34 and I need to know what local date and time that corresponds to for that IP's location, including whether DST was in effect."}],"resultDescription":"Returns an ISO 8601 date-time string representing the current local time at the IP's location, the day of the week, the IANA timezone name, and a boolean flag indicating whether Daylight Saving Time is currently active.","failureModes":["Invalid or private/reserved IP address returns an error or empty result","Unroutable IPs (e.g. 127.0.0.1, 192.168.x.x) may not resolve to a geographic location","Upstream TimeAPI outage causes degraded or failed response","Malformed request body results in HTTP 400","Payment failure or insufficient balance returns HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need to determine the current local time for a user or device identified only by an IP address, without holding a TimeAPI key yourself. It is ideal for agents that personalize experiences, schedule actions, or localize timestamps based on inferred user location, and when you want a keyless, pay-per-call approach via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:22.866Z","isFirstParty":false}