> ## Documentation Index
> Fetch the complete documentation index at: https://developers.flameproxies.com/llms.txt
> Use this file to discover all available pages before exploring further.

# curl

> Working curl commands for FlameProxies residential, premium residential, and static proxies. Covers rotating and sticky sessions with copy-paste examples.

curl is the quickest way to test FlameProxies from your terminal. Every example on this page is a single command you can copy, paste, and run.

Replace `USERNAME` and `PASSWORD` with your package credentials from the [dashboard](https://flameproxies.com/dashboard).

## Residential proxies

### Rotating (new IP every request)

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us:PASSWORD" https://ipinfo.io/json
```

Run this several times and you'll get a different IP each time.

### Target a specific city

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us-city-newyorkcity:PASSWORD" https://ipinfo.io/json
```

### Sticky session (same IP across requests)

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us-session-a1b2-time-30:PASSWORD" https://ipinfo.io/json
```

Run this several times with the same session ID and you'll see the same IP for up to 30 minutes.

### Sub-pool

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us-pool-2:PASSWORD" https://ipinfo.io/json
```

### Fast mode (lowest latency)

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us-mode-fast:PASSWORD" https://ipinfo.io/json
```

## Premium residential proxies

Premium residential uses the same format. Change `package-standard` to `package-premium`.

### Rotating

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-premium-country-us:PASSWORD" https://ipinfo.io/json
```

### Sticky session

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-premium-country-gb-session-c3d4-time-20:PASSWORD" https://ipinfo.io/json
```

## SOCKS5

To connect over SOCKS5, use port `1080`. `--socks5-hostname` resolves the target hostname through the proxy:

```bash theme={null}
curl --socks5-hostname proxy.flameproxies.com:1080 --proxy-user "USERNAME-package-standard-country-us:PASSWORD" https://ipinfo.io/json
```

Or pass the whole proxy as a URL:

```bash theme={null}
curl -x "socks5h://USERNAME-package-standard-country-us:PASSWORD@proxy.flameproxies.com:1080" https://ipinfo.io/json
```

## Static residential (ISP) proxies

Static proxies use a dedicated host for each IP:

```bash theme={null}
curl -x 203.0.113.10.static.flameproxies.com:1337 -U "USERNAME-203.0.113.10:PASSWORD" https://ipinfo.io/json
```

Replace `203.0.113.10` with your static IP. The dashboard shows the exact line for each IP you own.

ISP Monthly IPs (United States) connect straight to the IP instead, with no `.static.flameproxies.com` hostname:

```bash theme={null}
curl -x 203.0.113.10:PORT -U "USERNAME:PASSWORD" https://ipinfo.io/json
```

## Measuring timing

Add `-w` to see where time goes in a request:

```bash theme={null}
curl -x proxy.flameproxies.com:8989 -U "USERNAME-package-standard-country-us:PASSWORD" \
  -o /dev/null -s \
  -w "connect: %{time_connect}s  tls: %{time_appconnect}s  total: %{time_total}s\n" \
  https://ipinfo.io/json
```

See [Proxy speed & latency](/troubleshooting/proxy-speed-latency) for how to read the results.

## Expected response

All examples return a JSON response from [ipinfo.io](https://ipinfo.io):

```json theme={null}
{
  "ip": "203.0.113.45",
  "city": "Los Angeles",
  "country": "US",
  "timezone": "America/Los_Angeles"
}
```

The `ip` should be different from your real IP. If you targeted a country, `country` should match.

## Next steps

<CardGroup cols={2}>
  <Card title="Python examples" icon="python" href="/examples/python">
    Working Python code for FlameProxies.
  </Card>

  <Card title="Node.js examples" icon="node-js" href="/examples/nodejs">
    Working Node.js code for FlameProxies.
  </Card>

  <Card title="Connection debugging" icon="wrench" href="/troubleshooting/connection-debugging">
    What to do when something goes wrong.
  </Card>

  <Card title="Residential proxies" icon="house-signal" href="/proxies/residential">
    Full parameter reference.
  </Card>
</CardGroup>