{"openapi":"3.1.0","info":{"title":"KEVAREMESH x402 API Gateway","version":"18.10.26","description":"Buyer-first x402 API gateway plus market-validated paid capabilities for AI agents: web search/content, blockchain, finance, crypto, news/social, enrichment, geospatial data, AI generation, travel and utilities.","contact":{"name":"KEVAREMESH Support","url":"https://kevaremesh-web.vercel.app/api/x402/support","email":"cirralink@gmail.com"},"x-guidance":"For a known owned capability, call it directly. Otherwise use the Gateway or MCP kevaremesh_use so KEVAREMESH can choose and adapt external supply without making the buyer compare providers. On HTTP 402, decode payment-required (or read the equivalent JSON body), pay/sign one accepts entry, and retry the same request with payment-signature."},"externalDocs":{"description":"KEVAREMESH overview and connection details","url":"https://kevaremesh-web.vercel.app/api/x402/about"},"servers":[{"url":"https://kevaremesh-web.vercel.app"}],"paths":{"/api/x402/web-content-retrieval":{"post":{"operationId":"kevaremesh_fetch_url","summary":"Fetch clean text from a public URL","description":"Fetch a known public HTTP(S) URL and return bounded, LLM-ready plain text plus title, final URL, HTTP status, content type, truncation status, and SHA-256. Use when an agent already has a URL and needs its current readable content. No browser rendering, login/paywall/CAPTCHA bypass, or private-network access.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public HTTP(S) URL whose current readable content the agent already knows it needs."},"max_bytes":{"type":"integer","default":262144,"maximum":524288,"minimum":1024,"description":"Maximum response bytes to read before truncating. Use a smaller value when only a short context window is needed."},"include_html":{"type":"boolean","default":false,"description":"Also return bounded raw HTML when the resource is HTML. Leave false when normalized text is sufficient."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["requested_url","final_url","status","content_type","bytes","truncated","text","sha256"],"properties":{"html":{"type":["string","null"],"description":"Raw bounded HTML only when include_html=true and the resource is HTML."},"text":{"type":"string","description":"Normalized readable text for agent context."},"bytes":{"type":"integer","minimum":0,"description":"Bytes read before the configured cap."},"title":{"type":["string","null"],"description":"HTML title when present."},"sha256":{"type":"string","description":"SHA-256 hex digest of the bounded upstream text payload."},"status":{"type":"integer","description":"Upstream HTTP status."},"final_url":{"type":"string","format":"uri","description":"Final public URL after validated redirects."},"truncated":{"type":"boolean","description":"True when the response hit the byte cap."},"content_type":{"type":"string","description":"Upstream Content-Type."},"requested_url":{"type":"string","format":"uri","description":"URL requested by the caller."}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/x402-client-test-cdp-x402-client-test":{"post":{"operationId":"kevaremesh_x402_ping","summary":"Run a minimal end-to-end x402 paid ping","description":"Minimal end-to-end x402 payment test. Pay once, optionally echo a message, and receive a successful JSON response proving challenge-payment-retry compatibility.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":500,"description":"Optional value echoed after successful paid execution"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["ok","paid_x402_endpoint","server_time_utc","purpose"],"properties":{"ok":{"type":"boolean"},"echo":{"type":["string","null"]},"purpose":{"type":"string"},"server_time_utc":{"type":"string","format":"date-time"},"paid_x402_endpoint":{"type":"boolean"}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/timezone-conversion-cdp-timezone-conversion":{"post":{"operationId":"kevaremesh_convert_timezone","summary":"Convert local time across IANA time zones","description":"Convert a local ISO date-time from one IANA time zone to another with explicit daylight-saving-time handling. Rejects nonexistent spring-forward times and, by default, ambiguous fall-back times instead of silently guessing. Use for scheduling, deadlines, and cross-region coordination.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["local_time","from_zone","to_zone"],"properties":{"to_zone":{"type":"string","description":"IANA target timezone, for example America/New_York"},"ambiguity":{"enum":["reject","earlier","later"],"type":"string","default":"reject","description":"How to resolve a duplicated local time during DST fall-back. Default reject prevents silent guessing."},"from_zone":{"type":"string","description":"IANA source timezone, for example Asia/Tokyo"},"local_time":{"type":"string","description":"Local ISO datetime without offset, for example 2026-09-18T09:00:00"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["input","source","utc_iso","target","dst_aware","ambiguity"],"properties":{"input":{"type":"object","required":["local_time","from_zone","to_zone","ambiguity"],"properties":{"to_zone":{"type":"string"},"ambiguity":{"type":"string"},"from_zone":{"type":"string"},"local_time":{"type":"string"}}},"source":{"type":"object","required":["zone","iso","offset_minutes","is_in_dst"],"properties":{"iso":{"type":"string"},"zone":{"type":"string"},"is_in_dst":{"type":"boolean"},"offset_name":{"type":"string"},"offset_minutes":{"type":"integer"}}},"target":{"type":"object","required":["zone","iso","local_time","offset_minutes","weekday","is_in_dst"],"properties":{"iso":{"type":"string"},"zone":{"type":"string"},"weekday":{"type":"string"},"is_in_dst":{"type":"boolean"},"local_time":{"type":"string"},"offset_name":{"type":"string"},"offset_minutes":{"type":"integer"}}},"utc_iso":{"type":"string","description":"Resolved UTC instant in ISO 8601 form."},"ambiguity":{"type":"object","required":["ambiguous","possible_offsets_minutes","resolution"],"properties":{"ambiguous":{"type":"boolean"},"resolution":{"type":"string"},"possible_offsets_minutes":{"type":"array","items":{"type":"integer"}}}},"dst_aware":{"type":"boolean"}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/unit-conversion-cdp-unit-conversion":{"post":{"operationId":"kevaremesh_convert_units","summary":"Convert common units deterministically","description":"Convert common mass, length, and temperature units deterministically with no external provider dependency.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["value","from_unit","to_unit"],"properties":{"value":{"type":"number","description":"Numeric value to convert"},"to_unit":{"type":"string","description":"Target unit in the same measurement family"},"from_unit":{"type":"string","description":"Source unit, e.g. kg, lb, km, mi, celsius, fahrenheit"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["input","category","value","unit"],"properties":{"unit":{"type":"string"},"input":{"type":"object"},"value":{"type":"number"},"category":{"type":"string"}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/cryptographic-hash-cdp-cryptographic-hash":{"post":{"operationId":"kevaremesh_hash","summary":"Hash text with SHA-256, SHA-384, or SHA-512","description":"Hash UTF-8 text with SHA-256, SHA-384, or SHA-512 for integrity checks, fingerprints, cache keys, and deterministic digests.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":262144},"algorithm":{"enum":["sha256","sha384","sha512"],"type":"string","default":"sha256"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/x402-endpoint-verification-cdp-x402-endpoint-verification":{"post":{"operationId":"kevaremesh_verify_x402","summary":"Preflight an x402 endpoint before paying","description":"Preflight a public x402 endpoint before paying. Check its x402 metadata and OpenAPI payment declarations and optionally send an unpaid GET probe to detect a live 402 challenge. Returns a readiness verdict, score, checks, and safety flags; never signs or sends payment and never POSTs to the target.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public x402 endpoint URL to verify"},"probe_get":{"type":"boolean","default":false,"description":"Optionally send a no-payment GET probe after metadata checks. POST is never sent."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["url","verdict","score","checks","safety","generated_at"],"properties":{"url":{"type":"string","format":"uri","description":"Endpoint base URL that was checked."},"score":{"type":"integer","maximum":100,"minimum":0},"checks":{"type":"object","required":["metadata","openapi","live_get"],"properties":{"openapi":{"type":"object","description":"OpenAPI availability plus x-payment-info and 402 documentation checks."},"live_get":{"type":"object","description":"Optional unpaid GET challenge probe result."},"metadata":{"type":"object","description":"x402 metadata availability and parsed payment summary."}}},"safety":{"type":"object","required":["funds_moved","payment_signed","post_request_sent","private_network_blocked"],"properties":{"funds_moved":{"type":"boolean"},"payment_signed":{"type":"boolean"},"post_request_sent":{"type":"boolean"},"private_network_blocked":{"type":"boolean"}}},"verdict":{"enum":["ready","metadata_ready","partial","not_verified"],"type":"string"},"generated_at":{"type":"string","format":"date-time"}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/secure-random-cdp-secure-random":{"post":{"operationId":"kevaremesh_secure_random","summary":"Generate cryptographically secure random bytes or an integer","description":"Generate cryptographically secure random bytes or a bounded integer using Web Crypto.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"max":{"type":"integer"},"min":{"type":"integer"},"bytes":{"type":"integer","default":32,"maximum":1024,"minimum":1}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/utc-timestamp-cdp-utc-timestamp":{"post":{"operationId":"kevaremesh_utc_time","summary":"Return the current server UTC timestamp","description":"Return the current KEVAREMESH server UTC timestamp plus Unix epoch seconds and milliseconds. No cryptographic time attestation is claimed.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["iso_utc","epoch_seconds","epoch_milliseconds","timezone"],"properties":{"iso_utc":{"type":"string","format":"date-time"},"timezone":{"type":"string","const":"UTC"},"epoch_seconds":{"type":"integer"},"epoch_milliseconds":{"type":"integer"}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/file-hosting-upload-storage":{"post":{"operationId":"kevaremesh_host_file","summary":"Host a small agent file temporarily","description":"Store one agent-generated JSON, text, CSV, PNG, JPEG, or WebP file up to 1 MiB in private temporary storage for 5 minutes to 24 hours and return a signed download URL. Use for agent-to-agent or agent-to-human artifact handoff without creating an account.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["filename","content_type","content_base64"],"properties":{"filename":{"type":"string","maxLength":120,"description":"Download filename to preserve for the recipient."},"ttl_seconds":{"type":"integer","default":3600,"maximum":86400,"minimum":300,"description":"How long the signed file should remain available, from 5 minutes to 24 hours."},"content_type":{"enum":["application/json","text/plain","text/csv","image/png","image/jpeg","image/webp"],"type":"string","description":"Declared MIME type; bytes are validated against supported formats before storage."},"content_base64":{"type":"string","description":"Base64-encoded file content, maximum decoded size 1 MiB"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["url","expires_at","retention_seconds","bytes","content_type","filename","sha256"],"properties":{"url":{"type":"string","format":"uri","description":"Time-limited signed download URL."},"bytes":{"type":"integer","maximum":1048576,"minimum":0},"sha256":{"type":"string","description":"SHA-256 hex digest of the stored bytes."},"filename":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"content_type":{"type":"string"},"retention_seconds":{"type":"integer","maximum":86400,"minimum":300}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/uuid-v4-cdp-uuid-generation":{"post":{"operationId":"kevaremesh_uuid_v4","summary":"Generate UUID v4 identifiers","description":"Generate random UUID identifiers for agent and software workflows.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","default":1,"maximum":100,"minimum":1}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/json-validation-cdp-json-validation":{"post":{"operationId":"kevaremesh_json_validate","summary":"Validate and normalize JSON text","description":"Validate JSON text, return parse status, normalize valid JSON, and optionally pretty-print it without an external provider.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":262144},"pretty":{"type":"boolean","default":true}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["valid","type","normalized_json","pretty_json","error"],"properties":{"type":{"type":["string","null"]},"error":{"type":["string","null"]},"valid":{"type":"boolean"},"pretty_json":{"type":["string","null"]},"normalized_json":{"type":["string","null"]}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/service-uptime-cdp-service-uptime":{"post":{"operationId":"kevaremesh_uptime","summary":"Check public URL uptime and HEAD latency","description":"Check a public HTTP(S) URL with a safe HEAD request and return point-in-time reachability, HTTP status, redirect count and latency. Private/local targets are blocked.","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocol":"x402","version":2,"network":"eip155:8453","payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","asset":"USDC"},"parameters":[{"name":"payment-signature","in":"header","required":false,"description":"x402 payment signature/proof supplied when retrying a request after a 402 challenge.","schema":{"type":"string"}},{"name":"x-payment","in":"header","required":false,"description":"Compatibility alias for an x402 payment signature/proof.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public HTTP(S) URL to check"},"timeout_ms":{"type":"integer","default":5000,"maximum":8000,"minimum":1000,"description":"Per-request HEAD timeout in milliseconds"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful paid capability execution","content":{"application/json":{"schema":{"type":"object","required":["service","product","tool_name","result","generated_at","limitations"],"properties":{"result":{"type":"object","required":["requested_url","final_url","reachable","ok","status","latency_ms","redirected","redirect_count","checked_at","method","error"],"properties":{"ok":{"type":"boolean"},"error":{"type":["string","null"]},"method":{"type":"string","const":"HEAD"},"status":{"type":["integer","null"]},"final_url":{"type":"string","format":"uri"},"reachable":{"type":"boolean"},"checked_at":{"type":"string","format":"date-time"},"latency_ms":{"type":"number","minimum":0},"redirected":{"type":"boolean"},"content_type":{"type":["string","null"]},"requested_url":{"type":"string","format":"uri"},"redirect_count":{"type":"integer","maximum":4,"minimum":0}}},"product":{"type":"string","description":"Stable KEVAREMESH product key."},"service":{"type":"string","const":"KEVAREMESH"},"tool_name":{"type":"string","description":"Short capability tool name."},"limitations":{"type":"array","items":{"type":"string"},"description":"Known capability limits relevant to safe use."},"generated_at":{"type":"string","format":"date-time"}}}}}},"402":{"description":"x402 v2 payment required. Pay/sign an accepts entry, then retry this POST with payment-signature.","headers":{"payment-required":{"description":"Base64-encoded x402 v2 PaymentRequired JSON. Decode this value, choose an accepts entry, sign/pay it, then retry the original request with payment-signature.","schema":{"type":"string"}},"x-payment-required":{"description":"Compatibility alias carrying the same Base64-encoded x402 v2 PaymentRequired JSON.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/gateway":{"post":{"operationId":"kevaremesh_gateway_route","summary":"Auto-select an x402 API for search, data, finance, blockchain, AI, enrichment or travel","description":"Buyer-side x402 API gateway for web search/content, blockchain and wallet data, finance, crypto, news/social, enrichment, geocoding/geospatial data, AI generation, audio transcription, video generation, code/research intelligence, weather, property, domain/DNS, document processing, prediction-market data, travel, screenshots, uptime, speech and x402 discovery. If no predefined family fits, KEVAREMESH can search permissionless read-oriented supply by the buyer goal. Provider discovery and route preparation are free; the buyer does not need to choose a provider.","tags":["x402","API Gateway","Search","Data","Finance","Blockchain","AI","Enrichment","Travel"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["requirements"],"properties":{"requirements":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","required":["capability"],"properties":{"capability":{"type":"string","description":"KEVAREMESH capability cluster such as web_search, weather_data, llm_inference, or generic_api"},"goal":{"type":"string","maxLength":500,"description":"Optional buyer objective used to rank and adapt providers. For generic_api this is the primary intent signal."},"resource":{"type":"string","format":"uri","description":"Optional exact provider resource selected during a prior free quote. When supplied, KEVAREMESH keeps that provider fixed instead of silently substituting another."},"quantity":{"type":"integer","minimum":1,"maximum":1000,"default":1},"max_unit_price_usd":{"type":"number","minimum":0},"min_unique_payers_30d":{"type":"integer","minimum":0},"request":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST"],"default":"POST"},"query":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"body":{}},"additionalProperties":false},"requests":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST"],"default":"POST"},"query":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"body":{}},"additionalProperties":false}}}}},"preference":{"type":"string","enum":["balanced","cheapest","proven"],"default":"balanced"},"max_total_upstream_usd":{"type":"number","minimum":0}},"additionalProperties":false}}}},"responses":{"200":{"description":"Prepared route and upstream payment challenges"},"422":{"description":"Invalid input"},"502":{"description":"No executable upstream candidate"}}}},"/api/x402/gateway/quote":{"post":{"operationId":"kevaremesh_gateway_quote","summary":"Compare x402 providers automatically before paying","description":"Free buyer-side discovery, provider comparison and route planning across web search/content, blockchain, finance, crypto, news/social, enrichment, AI, geospatial and travel capabilities.","tags":["x402","API Gateway","Discovery","Search","Data"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["requirements"],"properties":{"requirements":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","required":["capability"],"properties":{"capability":{"type":"string","description":"KEVAREMESH capability cluster such as web_search, weather_data, llm_inference, or generic_api"},"goal":{"type":"string","maxLength":500,"description":"Optional buyer objective used to rank and adapt providers. For generic_api this is the primary intent signal."},"resource":{"type":"string","format":"uri","description":"Optional exact provider resource selected during a prior free quote. When supplied, KEVAREMESH keeps that provider fixed instead of silently substituting another."},"quantity":{"type":"integer","minimum":1,"maximum":1000,"default":1},"max_unit_price_usd":{"type":"number","minimum":0},"min_unique_payers_30d":{"type":"integer","minimum":0},"request":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST"],"default":"POST"},"query":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"body":{}},"additionalProperties":false},"requests":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST"],"default":"POST"},"query":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"body":{}},"additionalProperties":false}}}}},"preference":{"type":"string","enum":["balanced","cheapest","proven"],"default":"balanced"},"max_total_upstream_usd":{"type":"number","minimum":0}},"additionalProperties":false}}}},"responses":{"200":{"description":"Free route quote"},"422":{"description":"Invalid input"}}}},"/api/x402/gateway/execute":{"post":{"operationId":"kevaremesh_gateway_execute","summary":"Execute the auto-selected x402 provider","description":"Execute one KEVAREMESH-selected upstream x402 request. No KEVAREMESH fee is charged at this stage. First call returns the selected Provider's x402 challenge; the buyer pays the Provider directly and retries. Successful provider results are retrieved through /gateway/finalize. If this is the first successful routed external job without an active pass, finalization requests the $0.001 KEVAREMESH 24-hour Access Pass; while the pass is active, no additional KEVAREMESH gateway fee is charged.","tags":["x402","API Gateway","Execution"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["execution_token","request"],"properties":{"execution_token":{"type":"string","minLength":20},"request":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST"],"default":"POST"},"query":{"type":"object","additionalProperties":{"type":["string","number","boolean"]}},"body":{}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"Upstream succeeded; result ready for finalization"},"402":{"description":"Selected upstream Provider payment required"},"409":{"description":"Execution token invalid, expired, used, or request mismatch"},"422":{"description":"Invalid input"},"502":{"description":"Upstream execution failed"}}}},"/api/x402/gateway/finalize":{"post":{"operationId":"kevaremesh_gateway_finalize","summary":"Finalize a successful routed job and receive provider results","description":"Available only after all prepared upstream executions succeeded. If the client has no active Access Pass, the first successful routed job requests a $0.001 24-hour Access Pass payment; otherwise finalization is free while the pass remains active. A valid finalize token can re-read an already finalized job without another charge.","security":[],"x-kevaremesh-access-pass":{"price_usd":0.001,"ttl_seconds":86400,"charged_only_after_first_success":true,"additional_gateway_fee_while_active_usd":0,"provider_payment_only":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gateway_request_id","finalize_token"],"properties":{"gateway_request_id":{"type":"string","format":"uuid"},"finalize_token":{"type":"string","minLength":20}},"additionalProperties":false}}}},"responses":{"200":{"description":"Final provider results","content":{"application/json":{"schema":{"type":"object","required":["service","product","gateway_request_id","job_success","gateway_payment_settled","gateway_fee_usd","results"],"properties":{"service":{"type":"string"},"product":{"type":"string"},"gateway_request_id":{"type":"string","format":"uuid"},"job_success":{"type":"boolean"},"gateway_payment_settled":{"type":"boolean"},"gateway_fee_usd":{"type":"number"},"upstream_execution_count":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}},"generated_at":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"Job not successfully completed"},"422":{"description":"Invalid request"}}}}},"x-discovery":{"payTo":"0x08f840E3b1b8c31e5Ca56956169705907489E934","network":"eip155:8453","ownershipProofs":[],"mcp":"https://kevaremesh-web.vercel.app/api/x402/mcp","mcpRegistryName":"io.github.cirralink-stack/kevaremesh-gateway","llms":"https://kevaremesh-web.vercel.app/llms.txt","robots":"https://kevaremesh-web.vercel.app/robots.txt","sitemap":"https://kevaremesh-web.vercel.app/sitemap.xml","capabilities":["web_search","web_content_retrieval","blockchain_data","financial_data","crypto_risk_analysis","crypto_market_data","news_intelligence","social_search","people_enrichment","business_enrichment","business_verification","email_enrichment","geocoding","geolocation_data","geospatial_data","llm_inference","image_generation","audio_transcription","video_generation","code_intelligence","research_analysis","weather_data","property_data","domain_dns_data","document_processing","prediction_market_data","travel_availability","travel_search","hotel_availability","website_screenshot","service_uptime","text_to_speech","x402_resource_search","x402_endpoint_verification","generic_api","public_web_content_fetch","retrieve_content_from_urls","x402_client_test","test_x402_payment_client","timezone_conversion","convert_time_between_timezones","unit_conversion","convert_units_and_measurements","cryptographic_hash","hash_text_or_payload","verify_x402_endpoint_readiness","secure_random","generate_secure_randomness","utc_timestamp","retrieve_current_utc_timestamp","temporary_file_hosting","upload_and_host_files","uuid_generation","generate_uuid_identifiers","json_validation","validate_or_format_json","retrieve_service_uptime_metrics"],"ownedProducts":[{"name":"KEVAREMESH Web Content Retrieval","buyer_job":"retrieve_content_from_urls","module_kind":"public_web_content_fetch","url":"https://kevaremesh-web.vercel.app/api/x402/web-content-retrieval","price_usd":0.001},{"name":"KEVAREMESH x402 Paid Ping","buyer_job":"test_x402_payment_client","module_kind":"x402_client_test","url":"https://kevaremesh-web.vercel.app/api/x402/x402-client-test-cdp-x402-client-test","price_usd":0.001},{"name":"KEVAREMESH Time Zone Conversion","buyer_job":"convert_time_between_timezones","module_kind":"timezone_conversion","url":"https://kevaremesh-web.vercel.app/api/x402/timezone-conversion-cdp-timezone-conversion","price_usd":0.001},{"name":"KEVAREMESH Unit Converter","buyer_job":"convert_units_and_measurements","module_kind":"unit_conversion","url":"https://kevaremesh-web.vercel.app/api/x402/unit-conversion-cdp-unit-conversion","price_usd":0.001},{"name":"KEVAREMESH Cryptographic Hash","buyer_job":"hash_text_or_payload","module_kind":"cryptographic_hash","url":"https://kevaremesh-web.vercel.app/api/x402/cryptographic-hash-cdp-cryptographic-hash","price_usd":0.001},{"name":"KEVAREMESH x402 Endpoint Verification","buyer_job":"verify_x402_endpoint_readiness","module_kind":"x402_endpoint_verification","url":"https://kevaremesh-web.vercel.app/api/x402/x402-endpoint-verification-cdp-x402-endpoint-verification","price_usd":0.001},{"name":"KEVAREMESH Secure Random","buyer_job":"generate_secure_randomness","module_kind":"secure_random","url":"https://kevaremesh-web.vercel.app/api/x402/secure-random-cdp-secure-random","price_usd":0.001},{"name":"KEVAREMESH UTC Timestamp","buyer_job":"retrieve_current_utc_timestamp","module_kind":"utc_timestamp","url":"https://kevaremesh-web.vercel.app/api/x402/utc-timestamp-cdp-utc-timestamp","price_usd":0.001},{"name":"KEVAREMESH Temporary File Hosting","buyer_job":"upload_and_host_files","module_kind":"temporary_file_hosting","url":"https://kevaremesh-web.vercel.app/api/x402/file-hosting-upload-storage","price_usd":0.001},{"name":"Uuid Generation for generate_uuid_identifiers","buyer_job":"generate_uuid_identifiers","module_kind":"uuid_generation","url":"https://kevaremesh-web.vercel.app/api/x402/uuid-v4-cdp-uuid-generation","price_usd":0.005},{"name":"KEVAREMESH JSON Validation & Formatter","buyer_job":"validate_or_format_json","module_kind":"json_validation","url":"https://kevaremesh-web.vercel.app/api/x402/json-validation-cdp-json-validation","price_usd":0.001},{"name":"KEVAREMESH Service Uptime","buyer_job":"retrieve_service_uptime_metrics","module_kind":"service_uptime","url":"https://kevaremesh-web.vercel.app/api/x402/service-uptime-cdp-service-uptime","price_usd":0.001}],"gateway":{"mcp":"https://kevaremesh-web.vercel.app/api/x402/mcp","tool":"kevaremesh_use","provider_selection":"automatic","access_pass":{"price_usd":0.001,"ttl_seconds":86400,"charged_only_after_first_success":true,"additional_gateway_fee_while_active_usd":0},"buyer_direct_provider_payments":true,"input_adaptation":"automatic","live_directory_search":true,"catalog":"https://kevaremesh-web.vercel.app/api/x402/gateway/catalog"}}}