Skip to content

Proxied fetch

The Javascript Fetch API is directly available within a Val. However, the requests sent using this API are not proxied or retried. This is problematic in some use cases where requests may be blocked by the receiving server for using particular IP addresses. Additionally, network blips or unreliable web services may lead to failed Vals if not handled properly.

The Val Town standard library contains an alternative version, std/fetch, that wraps the Javascript Fetch API to provide additional functionality. The fetch function from std/fetch reroutes requests using a proxy vendor so that requests obtain different IP addresses. It also automatically retries failed requests several times. Note that using std/fetch may be significantly slower than directly calling the Javascript Fetch API due to extra network hops.


After importing std/fetch, the fetch method is used with the same signature as the Javascript Fetch API.

ExampleRun in Val Town ↗
import { fetch } from "";
let result = await fetch("");
let json = await result.json();

If you run the above code multiple times, you’ll see that it returns different IP addresses, because std/fetch uses proxies so that each request is made from a different IP address.