price_history_movers

Pack: price-history · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/price_history_movers for the schema, then POST the same URL with its arguments for the data.

What changed in a feed between two dates: entities whose compared value moved (largest absolute move first, with before, after, delta and percent), entities that appeared, and entities that left. Dates before the feed first_observed compare against nothing and the response says so.

Parameters

NameTypeRequiredDescription
feedstringyesFeed id: gpu-rental or appstore-charts
fromstringyesStart of the comparison, ISO date or timestamp, e.g. 2026-11-21
tostringnoEnd of the comparison (default now)
groupstringnoNarrow to one group, e.g. aws or us/top-free
limitnumbernoMaximum rows per list (default 25, max 200)

Example call

Arguments

{
  "feed": "appstore-charts",
  "from": "2026-11-20T19:56:00Z",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/price-history/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"price_history_movers","arguments":{"feed":"appstore-charts","from":"2026-11-20T19:56:00Z","limit":3}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('price_history_movers', {
  "feed": "appstore-charts",
  "from": "2026-11-20T19:56:00Z",
  "limit": 3
});

Response shape

FieldTypeDescription
feedstring
publisherstring
datasetstring
history_beginsstring
data_as_ofstring
coverage_notestring
fromstring
tostring
compared_fieldstring
sensestring
moved_countnumber
appeared_countnumber
left_countnumber
unchanged_countnumber
movedarray
appearedarray
leftarray
truncatedboolean
notenull
Full JSON Schema
{
  "type": "object",
  "properties": {
    "feed": {
      "type": "string"
    },
    "publisher": {
      "type": "string"
    },
    "dataset": {
      "type": "string"
    },
    "history_begins": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "coverage_note": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "compared_field": {
      "type": "string"
    },
    "sense": {
      "type": "string"
    },
    "moved_count": {
      "type": "number"
    },
    "appeared_count": {
      "type": "number"
    },
    "left_count": {
      "type": "number"
    },
    "unchanged_count": {
      "type": "number"
    },
    "moved": {
      "type": "array",
      "items": {
        "type": [
          null,
          "object"
        ],
        "properties": {
          "entity_id": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "price_usd_hr_before": {
            "type": "number"
          },
          "price_usd_hr_after": {
            "type": "number"
          },
          "delta": {
            "type": "number"
          },
          "pct_change": {
            "type": "number"
          },
          "direction": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "appeared": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "chart": {
            "type": "string"
          },
          "rank": {
            "type": "number"
          },
          "app_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "developer": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "instance": {
            "type": "string"
          },
          "gpu_model": {
            "type": "null"
          },
          "gpu_count": {
            "type": "number"
          },
          "vram_gb": {
            "type": "number"
          },
          "price_usd_hr": {
            "type": "number"
          },
          "billing": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "left": {
      "type": "array",
      "items": {
        "type": [
          null,
          "object"
        ],
        "properties": {
          "entity_id": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "last_value": {
            "type": "number"
          },
          "provider": {
            "type": "string"
          },
          "instance": {
            "type": "string"
          },
          "gpu_model": {
            "type": [
              "string",
              "null"
            ]
          },
          "gpu_count": {
            "type": "number"
          },
          "vram_gb": {
            "type": "number"
          },
          "price_usd_hr": {
            "type": "number"
          },
          "billing": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "truncated": {
      "type": "boolean"
    },
    "note": {
      "type": "null"
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the price-history pack
{
  "mcpServers": {
    "price-history": {
      "url": "https://gateway.pipeworx.io/price-history/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 21, 2026