Watch U.S. and UK economic indicators as they are released

Create an API key under Console → API & access. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/ons-uk-unemployment-rate -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get ons-uk-unemployment-rate --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor UK unemployment rate, monthly (three-month average): get_catalog_source ons-uk-unemployment-rate,
then create_source with its create_source_args (dry run first), then run_source."

The request body the API and CLI examples send.

{
  "name": "UK unemployment rate, monthly (three-month average)",
  "url": "https://www.ons.gov.uk/employmentandlabourmarket/peoplenotinwork/unemployment/timeseries/mgsx/lms/data",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "months[*]",
    "fields": {
      "year": "year",
      "label": "label",
      "month": "month",
      "value": "value",
      "period": "date",
      "updated_at": "updateDate",
      "source_dataset": "sourceDataset"
    },
    "required": [
      "period",
      "value"
    ],
    "types": {
      "year": "integer",
      "value": "number",
      "updated_at": "datetime"
    }
  },
  "key_field": "period",
  "schedule": "daily",
  "rights": true,
  "catalog": {
    "slug": "ons-uk-unemployment-rate",
    "version_id": "3157fdf0-315f-4687-b824-deb16771712c"
  }
}

Create an API key under Console → API & access. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/new-york-weekly-gasoline-prices -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get new-york-weekly-gasoline-prices --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor New York State weekly retail gasoline prices by region: get_catalog_source new-york-weekly-gasoline-prices,
then create_source with its create_source_args (dry run first), then run_source."

The request body the API and CLI examples send.

{
  "name": "New York State weekly retail gasoline prices by region",
  "url": "https://data.ny.gov/resource/nqur-w4p7.json?$select=date,new_york_state_average_gal,albany_average_gal,batavia_average_gal,binghamton_average_gal,buffalo_average_gal,dutchess_average_gal,elmira_average_gal,glens_falls_average_gal,ithaca_average_gal,kingston_average_gal,nassau_average_gal,new_york_city_average_gal,rochester_average_gal,syracuse_average_gal,utica_average_gal,watertown_average_gal,white_plains_average_gal&$order=date%20DESC&$limit=52",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "[*]",
    "fields": {
      "week": "date",
      "utica": "utica_average_gal",
      "albany": "albany_average_gal",
      "elmira": "elmira_average_gal",
      "ithaca": "ithaca_average_gal",
      "nassau": "nassau_average_gal",
      "batavia": "batavia_average_gal",
      "buffalo": "buffalo_average_gal",
      "dutchess": "dutchess_average_gal",
      "kingston": "kingston_average_gal",
      "syracuse": "syracuse_average_gal",
      "rochester": "rochester_average_gal",
      "watertown": "watertown_average_gal",
      "binghamton": "binghamton_average_gal",
      "glens_falls": "glens_falls_average_gal",
      "white_plains": "white_plains_average_gal",
      "new_york_city": "new_york_city_average_gal",
      "new_york_state": "new_york_state_average_gal"
    },
    "required": [
      "week",
      "new_york_state"
    ],
    "types": {
      "week": "date",
      "utica": "number",
      "albany": "number",
      "elmira": "number",
      "ithaca": "number",
      "nassau": "number",
      "batavia": "number",
      "buffalo": "number",
      "dutchess": "number",
      "kingston": "number",
      "syracuse": "number",
      "rochester": "number",
      "watertown": "number",
      "binghamton": "number",
      "glens_falls": "number",
      "white_plains": "number",
      "new_york_city": "number",
      "new_york_state": "number"
    }
  },
  "key_field": "week",
  "schedule": "daily",
  "rights": true,
  "catalog": {
    "slug": "new-york-weekly-gasoline-prices",
    "version_id": "c6e28334-2a2e-4aab-b6d3-9cce79589ac6"
  }
}

Create an API key under Console → API & access. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/new-york-fed-sofr -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get new-york-fed-sofr --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor Secured Overnight Financing Rate (SOFR), daily: get_catalog_source new-york-fed-sofr,
then create_source with its create_source_args (dry run first), then run_source."

The request body the API and CLI examples send.

{
  "name": "Secured Overnight Financing Rate (SOFR), daily",
  "url": "https://markets.newyorkfed.org/api/rates/secured/sofr/last/30.json",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "refRates[*]",
    "fields": {
      "rate_type": "type",
      "percent_rate": "percentRate",
      "percentile_1": "percentPercentile1",
      "percentile_25": "percentPercentile25",
      "percentile_75": "percentPercentile75",
      "percentile_99": "percentPercentile99",
      "effective_date": "effectiveDate",
      "volume_billions": "volumeInBillions",
      "revision_indicator": "revisionIndicator"
    },
    "required": [
      "effective_date",
      "percent_rate"
    ],
    "types": {
      "percent_rate": "number",
      "percentile_1": "number",
      "percentile_25": "number",
      "percentile_75": "number",
      "percentile_99": "number",
      "effective_date": "date",
      "volume_billions": "number"
    }
  },
  "key_field": "effective_date",
  "schedule": "daily",
  "rights": true,
  "catalog": {
    "slug": "new-york-fed-sofr",
    "version_id": "6a2bcd79-eb6f-4f16-b41c-60f8ed188cd7"
  }
}