{"uid":"cap_Tzsl93y8Pg4aEgtoiZ-IC","slug":"apiosk-gateway-positionstack-geocoding-execution-f37308c8","name":"Apiosk Gateway – Positionstack Geocoding Execution","description":"Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.","url":"https://gateway.apiosk.com/positionstack/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"JSON payload forwarded to the selected operation."},"operation":{"type":"string","description":"Operation id, /path, or METHOD /path selector."}}},"responseSchema":{"type":"object","required":["status","result"],"properties":{"api":{"type":"string"},"cost":{"type":"string"},"result":{"description":"Upstream response body."},"status":{"type":"string"},"latency":{"type":"number"},"operation":{"type":"string"},"upstream_status":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.092","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i-Serz6dXpmCDMYLoSgDm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes pay-per-call geocoding and reverse geocoding requests via Positionstack through the Apiosk x402 gateway, charging $0.08 USDC per call on Base.","exampleAgentPrompt":"Look up the GPS coordinates for 1600 Pennsylvania Avenue NW, Washington DC — forward geocode it using Positionstack and give me the latitude and longitude.","exampleUseCases":[{"title":"Geocode a delivery address","prompt":"I need the latitude and longitude for 350 Fifth Avenue, New York, NY 10118 — can you geocode that address for me?"},{"title":"Reverse geocode GPS coordinates","prompt":"I have coordinates 48.8588443, 2.2943506 — can you reverse geocode those and tell me the street address they correspond to?"},{"title":"Enrich a dataset with coordinates","prompt":"I have a business address — 221B Baker Street, London — and I need its geographic coordinates so I can plot it on a map. Can you look that up?"}],"resultDescription":"Returns the upstream Positionstack geocoding response wrapped in a gateway envelope with fields: status (success/error), result (the Positionstack JSON body with latitude, longitude, label, country, region, postal code, etc.), api slug, operation used, HTTP upstream_status code, latency in milliseconds, and cost string.","failureModes":["Invalid or ambiguous address returns empty result array from Positionstack","Malformed JSON in the input field causes a gateway-level 400 error","Incorrect operation selector returns an operation-not-found error","Insufficient USDC balance or x402 payment failure blocks the call before it reaches upstream","Positionstack upstream outage returns non-200 upstream_status with error message in result","Rate limits on the Positionstack side may cause 429 upstream_status"],"whenToPreferThis":"Choose this endpoint when you need geocoding or reverse geocoding powered by Positionstack and want to pay per-call in USDC via the x402 protocol without managing a Positionstack API key directly. Ideal for agents operating in crypto-native, pay-as-you-go workflows on the Base blockchain where traditional API key billing is not suitable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:21.080Z","isFirstParty":false}