# costQL > Price GraphQL queries before they run: calibrate a live API into a static > pricing pack, then quote any query offline: in Python or JavaScript. Cost-units > only, never dollars. No hosted service; the pack is a plain local file. Install: `pip install costql` (build + quote) · `npm install costql` (quote only) ## Docs - [adapters](https://costql.com/docs/adapters/): --- description: "The one ~90-150 line file you write to onboard a GraphQL API to costQL, with zero engine changes: what it declares and how to write it." --- - [agents](https://costql.com/docs/agents/): --- description: "Hand a GraphQL API to a coding agent (Claude Code, Cursor) and let it write the costQL adapter and build the pricing pack for you." --- - [architecture](https://costql.com/docs/architecture/): --- description: "costQL end to end: introspect a live API, calibrate it into a static pricing pack, then quote any query offline. A deterministic path, no… - [contract](https://costql.com/docs/contract/): --- description: "The frozen v1.0 result shape every costQL quote follows: a billable price in cost-units, safe to bill on, at every tier and on every query."… - [demo-apis](https://costql.com/docs/demo-apis/): --- description: "The three real, unrelated GraphQL APIs costQL is proven against (TMDB, Rick & Morty, Northwind), each onboarded with one small adapter and a… - [evaluation](https://costql.com/docs/evaluation/): --- description: "The model, baseline, and dataset behind every costQL accuracy number, and how calibration and held-out query sets are kept disjoint." --- - [external-calls](https://costql.com/docs/external-calls/): --- description: "When a field calls an outside service (an LLM, a paid API), costQL names the call and observes its host; your app puts the price on it." --- - [faq](https://costql.com/docs/faq/): --- description: "Short answers to the most common costQL questions: does it call your API, what a price is in, dollars vs cost-units, and more." --- - [guides/query-limits](https://costql.com/docs/guides/query-limits/): --- description: "Query-complexity limits, demand control, and DoS protection all need a cost per query to threshold on. costQL measures that cost instead of… - [guides/x402](https://costql.com/docs/guides/x402/): --- description: "x402's upto scheme authorizes a ceiling and settles the actual amount. That is exactly the two numbers costQL already gives you: the… - [instrumentation](https://costql.com/docs/instrumentation/): --- description: "The one response extension (extensions.cost_trace) your GraphQL server emits to let costQL see per-resolver and shared work (T2/T3)." --- - [js](https://costql.com/docs/js/): --- description: "npm install costql gives you the quote side in JavaScript/TypeScript: load a pack and price queries offline in Node, browsers, or edge. Zero… - [limitations](https://costql.com/docs/limitations/): --- description: "Where costQL's typical estimate is least certain — cyclic-recursion and data-dependent queries. In every case the billable ceiling stays… - [pack-format](https://costql.com/docs/pack-format/): --- description: "What is inside a costQL pricing pack: the schema, fitted costs, observed sizes, and hosts, all in one self-contained file with no server or… - [publishing](https://costql.com/docs/publishing/): --- description: "A pack is a static JSON file. This is how to publish it so whoever prices a query — your own app, or a third party's agent — can fetch it… - [quickstart](https://costql.com/docs/quickstart/): --- description: "From a live GraphQL API to your first offline price in about a minute: install costQL, quote a demo pack, then build your own." --- - [quoting](https://costql.com/docs/quoting/): --- description: "What quote() accepts and what the price means: fragments, aliases, variables, and directives are all parsed, and wherever the price can't be… - [results/northwind](https://costql.com/docs/results/northwind/): --- description: "A batch-heavy database backend where entity sharing is heavy: the API shape that needs the tier that watches sharing (T3). Measured against… - [results/rickmorty](https://costql.com/docs/results/rickmorty/): --- description: "costQL priced a live public API it does not own with a 93-line adapter, zero engine changes, and ~96% accuracy at T1." --- - [results/tmdb](https://costql.com/docs/results/tmdb/): --- description: "Three-tier accuracy on the TMDB demo. On this lightly-sharing API there is almost no shared work to watch, so per-resolver timing (T2) and… - [tiers](https://costql.com/docs/tiers/): --- description: "costQL prices in one currency, work-ms, across three tiers of fidelity. T1 works on any API black-box; T2 and T3 see parallel and shared… ## Source - [GitHub](https://github.com/shapemachine/costql): engine, adapters, demos, packs, conformance oracle