# Chart Image Generator

Chart and graph generator: send JSON, get a designed chart image as PNG or SVG. Thirteen chart types, six themes, no browser.

Send labels and numbers, get back a chart you can drop into a report, an email, a slide or a chat reply. Thirteen types: column, bar, line, area, scatter, donut, pie, share bar, stat tile, sparkline, meter, heatmap and funnel. Six themes (light, dark, paper, slate, midnight, terminal) and six gradient backdrops that turn the chart into a share-ready card. Sizes for slides, squares, stories and link previews, PNG up to 3× or SVG. The details are handled for you: round axis numbers, labels placed so they do not overlap or run off the edge, colours that stay distinguishable for colour-blind readers, a highlight option that greys out everything but your point, goal lines, stacked and smooth variants. Latin, Greek and Cyrillic text.

- Thirteen types: column, bar, line, area, scatter, donut, pie, share bar, stat tile, sparkline, meter, heatmap and funnel.
- The details are done for you: round axis numbers, labels placed so they do not overlap or run off the edge, colours that stay distinguishable for colour-blind readers.
- Sizes for slides, squares, stories and link previews, PNG up to 3x or SVG, with a highlight option that greys out everything but your point.

## Calls

### `POST https://readymadeapi.com/v1/chart`

Render one chart as PNG or SVG from JSON: column, bar, line, area, scatter, donut, pie, share, stat, sparkline, meter, heatmap or funnel.

- Price: $0.002 per chart
- MCP tool: `chart_renderer_render`
- Answers in the same call.

Request:

```json
{
  "backdrop": "aurora",
  "labels": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"],
  "series": [
    {
      "name": "2025",
      "values": [42, 48, 51, 49, 58, 63]
    },
    {
      "name": "2026",
      "values": [61, 70, 74, 79, 85, 96]
    }
  ],
  "smooth": true,
  "theme": "midnight",
  "title": "Signups up 50% on last year",
  "type": "line"
}
```

The answer is the file itself (`image/png`).

## Limits

- One chart per call, PNG up to 3x or SVG.
- Up to 8 series, 60 bars and 500 points per chart.

## Questions

**Can I put the chart in an email or a chat reply?**

Yes. The answer is the image itself, so you can attach it, upload it or return it from your own endpoint.

**Which scripts can labels use?**

Latin, Greek and Cyrillic.

**Is it a wrapper around a JavaScript chart library?**

No. Charts are drawn by our own renderer, so the same input always gives the same image and no headless browser is involved.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
