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

# Working with pricing locations

> How to use pricing-location routes for hubs, zones, nodes, and nearby lookups.

## What pricing locations represent

Pricing locations are the named market points the public API uses for locational price lookups. Depending on the dataset, these can include:

* trading hubs
* zones
* nodes
* other location types present in the catalog

## Main routes

| Route                                      | Purpose                                       |
| ------------------------------------------ | --------------------------------------------- |
| `GET /v1/pricing_locations`                | list locations with filtering and sorting     |
| `GET /v1/pricing_locations/nearby`         | find locations near a coordinate or anchor id |
| `GET /v1/pricing_locations/{gs_entity_id}` | fetch one location in detail                  |

Use the `isos` parameter to target the market you want. See `/concepts/supported-markets` for currently supported market coverage.

## Example: list trading hubs

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.felixfusion.ai/v1/pricing_locations?isos=ercot&location_types=Trading%20Hub"
```

## Example: search by name

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.felixfusion.ai/v1/pricing_locations?isos=ercot&search=HB_HUBAVG"
```

## Example: nearby lookup

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.felixfusion.ai/v1/pricing_locations/nearby?isos=ercot&latitude=30.2672&longitude=-97.7431&limit=10"
```

## Example: single location details

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.felixfusion.ai/v1/pricing_locations/HB_HUBAVG?isos=ercot"
```