docs/guide/benchmarks.md
The benchmarks on this page measure TOON's performance across two key dimensions:
Benchmarks are organized into two tracks to ensure fair comparisons:
Benchmarks test LLM comprehension across different input formats using 209 data retrieval questions on 4 models.
<details> <summary><strong>Show Dataset Catalog</strong></summary>| Dataset | Rows | Structure | CSV Support | Eligibility |
|---|---|---|---|---|
| Uniform employee records | 100 | uniform | โ | 100% |
| E-commerce orders with nested structures | 50 | nested | โ | 33% |
| Time-series analytics data | 60 | uniform | โ | 100% |
| Top 100 GitHub repositories | 100 | uniform | โ | 100% |
| Semi-uniform event logs | 75 | semi-uniform | โ | 50% |
| Deeply nested configuration | 11 | deep | โ | 0% |
| Valid complete dataset (control) | 20 | uniform | โ | 100% |
| Array truncated: 3 rows removed from end | 17 | uniform | โ | 100% |
| Extra rows added beyond declared length | 23 | uniform | โ | 100% |
| Inconsistent field count (missing salary in row 10) | 20 | uniform | โ | 100% |
| Missing required fields (no email in multiple rows) | 20 | uniform | โ | 100% |
Structure classes:
CSV Support: โ (supported), โ (not supported โ would require lossy flattening)
Eligibility: Percentage of arrays that qualify for TOON's tabular format (uniform objects with primitive values)
</details>Each format ranked by efficiency (accuracy percentage per 1,000 tokens):
TOON โโโโโโโโโโโโโโโโโโโโ 27.7 acc%/1K tok โ 76.4% acc โ 2,759 tokens
JSON compact โโโโโโโโโโโโโโโโโโโโ 23.7 acc%/1K tok โ 73.7% acc โ 3,104 tokens
YAML โโโโโโโโโโโโโโโโโโโโ 19.9 acc%/1K tok โ 74.5% acc โ 3,749 tokens
JSON โโโโโโโโโโโโโโโโโโโโ 16.4 acc%/1K tok โ 75.0% acc โ 4,587 tokens
XML โโโโโโโโโโโโโโโโโโโโ 13.8 acc%/1K tok โ 72.1% acc โ 5,221 tokens
Efficiency score = (Accuracy % รท Tokens) ร 1,000. Higher is better.
[!TIP] TOON achieves 76.4% accuracy (vs JSON's 75.0%) while using 39.9% fewer tokens.
Note on CSV: Excluded from ranking as it only supports 109 of 209 questions (flat tabular data only). While CSV is highly token-efficient for simple tabular data, it cannot represent nested structures that other formats handle.
Accuracy across 4 LLMs on 209 data retrieval questions:
claude-haiku-4-5-20251001
โ TOON โโโโโโโโโโโโโโโโโโโโ 59.8% (125/209)
JSON โโโโโโโโโโโโโโโโโโโโ 57.4% (120/209)
YAML โโโโโโโโโโโโโโโโโโโโ 56.0% (117/209)
XML โโโโโโโโโโโโโโโโโโโโ 55.5% (116/209)
JSON compact โโโโโโโโโโโโโโโโโโโโ 55.0% (115/209)
CSV โโโโโโโโโโโโโโโโโโโโ 50.5% (55/109)
gemini-3-flash-preview
XML โโโโโโโโโโโโโโโโโโโโ 98.1% (205/209)
JSON โโโโโโโโโโโโโโโโโโโโ 97.1% (203/209)
YAML โโโโโโโโโโโโโโโโโโโโ 97.1% (203/209)
โ TOON โโโโโโโโโโโโโโโโโโโโ 96.7% (202/209)
JSON compact โโโโโโโโโโโโโโโโโโโโ 96.7% (202/209)
CSV โโโโโโโโโโโโโโโโโโโโ 96.3% (105/109)
gpt-5-nano
โ TOON โโโโโโโโโโโโโโโโโโโโ 90.9% (190/209)
JSON compact โโโโโโโโโโโโโโโโโโโโ 90.9% (190/209)
JSON โโโโโโโโโโโโโโโโโโโโ 89.0% (186/209)
CSV โโโโโโโโโโโโโโโโโโโโ 89.0% (97/109)
YAML โโโโโโโโโโโโโโโโโโโโ 87.1% (182/209)
XML โโโโโโโโโโโโโโโโโโโโ 80.9% (169/209)
grok-4-1-fast-non-reasoning
โ TOON โโโโโโโโโโโโโโโโโโโโ 58.4% (122/209)
YAML โโโโโโโโโโโโโโโโโโโโ 57.9% (121/209)
JSON โโโโโโโโโโโโโโโโโโโโ 56.5% (118/209)
XML โโโโโโโโโโโโโโโโโโโโ 54.1% (113/209)
JSON compact โโโโโโโโโโโโโโโโโโโโ 52.2% (109/209)
CSV โโโโโโโโโโโโโโโโโโโโ 51.4% (56/109)
<details> <summary><strong>Performance by dataset, model, and question type</strong></summary>[!TIP] TOON achieves 76.4% accuracy (vs JSON's 75.0%) while using 39.9% fewer tokens on these datasets.
| Question Type | TOON | JSON | YAML | JSON compact | XML | CSV |
|---|---|---|---|---|---|---|
| Field Retrieval | 99.6% | 99.3% | 98.5% | 98.5% | 98.9% | 100.0% |
| Aggregation | 61.9% | 61.9% | 59.9% | 58.3% | 54.4% | 50.9% |
| Filtering | 56.8% | 53.1% | 56.3% | 55.2% | 51.6% | 50.9% |
| Structure Awareness | 89.0% | 87.0% | 84.0% | 84.0% | 81.0% | 85.9% |
| Structural Validation | 70.0% | 60.0% | 60.0% | 55.0% | 85.0% | 80.0% |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 73.2% | 2,334 | 120/164 |
toon | 73.2% | 2,498 | 120/164 |
json-compact | 73.8% | 3,924 | 121/164 |
yaml | 73.8% | 4,959 | 121/164 |
json-pretty | 73.8% | 6,331 | 121/164 |
xml | 74.4% | 7,296 | 122/164 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
toon | 82.3% | 7,458 | 135/164 |
json-compact | 78.7% | 7,110 | 129/164 |
yaml | 79.9% | 8,755 | 131/164 |
json-pretty | 79.3% | 11,234 | 130/164 |
xml | 77.4% | 12,649 | 127/164 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 75.0% | 1,411 | 90/120 |
toon | 78.3% | 1,553 | 94/120 |
json-compact | 74.2% | 2,354 | 89/120 |
yaml | 75.8% | 2,954 | 91/120 |
json-pretty | 75.0% | 3,681 | 90/120 |
xml | 72.5% | 4,389 | 87/120 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 65.9% | 8,527 | 87/132 |
toon | 66.7% | 8,779 | 88/132 |
yaml | 65.2% | 13,141 | 86/132 |
json-compact | 59.8% | 11,464 | 79/132 |
json-pretty | 63.6% | 15,157 | 84/132 |
xml | 56.1% | 17,105 | 74/132 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
json-compact | 68.3% | 4,839 | 82/120 |
toon | 65.0% | 5,819 | 78/120 |
json-pretty | 69.2% | 6,817 | 83/120 |
yaml | 61.7% | 5,847 | 74/120 |
xml | 58.3% | 7,729 | 70/120 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
json-compact | 90.5% | 568 | 105/116 |
toon | 94.8% | 655 | 110/116 |
yaml | 93.1% | 675 | 108/116 |
json-pretty | 92.2% | 924 | 107/116 |
xml | 91.4% | 1,013 | 106/116 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
toon | 100.0% | 535 | 4/4 |
json-compact | 100.0% | 787 | 4/4 |
yaml | 100.0% | 992 | 4/4 |
json-pretty | 100.0% | 1,274 | 4/4 |
xml | 25.0% | 1,462 | 1/4 |
csv | 0.0% | 483 | 0/4 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 100.0% | 413 | 4/4 |
xml | 100.0% | 1,243 | 4/4 |
toon | 0.0% | 462 | 0/4 |
json-pretty | 0.0% | 1,085 | 0/4 |
yaml | 0.0% | 843 | 0/4 |
json-compact | 0.0% | 670 | 0/4 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 100.0% | 550 | 4/4 |
toon | 75.0% | 605 | 3/4 |
json-compact | 75.0% | 901 | 3/4 |
xml | 100.0% | 1,678 | 4/4 |
yaml | 75.0% | 1,138 | 3/4 |
json-pretty | 50.0% | 1,460 | 2/4 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 100.0% | 480 | 4/4 |
json-compact | 100.0% | 782 | 4/4 |
yaml | 100.0% | 985 | 4/4 |
toon | 100.0% | 1,008 | 4/4 |
json-pretty | 100.0% | 1,266 | 4/4 |
xml | 100.0% | 1,453 | 4/4 |
| Format | Accuracy | Tokens | Correct/Total |
|---|---|---|---|
csv | 100.0% | 340 | 4/4 |
xml | 100.0% | 1,409 | 4/4 |
toon | 75.0% | 974 | 3/4 |
json-pretty | 50.0% | 1,225 | 2/4 |
yaml | 25.0% | 951 | 1/4 |
json-compact | 0.0% | 750 | 0/4 |
| Format | Accuracy | Correct/Total |
|---|---|---|
toon | 59.8% | 125/209 |
json-pretty | 57.4% | 120/209 |
yaml | 56.0% | 117/209 |
xml | 55.5% | 116/209 |
json-compact | 55.0% | 115/209 |
csv | 50.5% | 55/109 |
| Format | Accuracy | Correct/Total |
|---|---|---|
xml | 98.1% | 205/209 |
json-pretty | 97.1% | 203/209 |
yaml | 97.1% | 203/209 |
toon | 96.7% | 202/209 |
json-compact | 96.7% | 202/209 |
csv | 96.3% | 105/109 |
| Format | Accuracy | Correct/Total |
|---|---|---|
toon | 90.9% | 190/209 |
json-compact | 90.9% | 190/209 |
json-pretty | 89.0% | 186/209 |
csv | 89.0% | 97/109 |
yaml | 87.1% | 182/209 |
xml | 80.9% | 169/209 |
| Format | Accuracy | Correct/Total |
|---|---|---|
toon | 58.4% | 122/209 |
yaml | 57.9% | 121/209 |
json-pretty | 56.5% | 118/209 |
xml | 54.1% | 113/209 |
json-compact | 52.2% | 109/209 |
csv | 51.4% | 56/109 |
This benchmark tests LLM comprehension and data retrieval accuracy across different input formats. Each LLM receives formatted data and must answer questions about it. This does not test the model's ability to generate TOON output โ only to read and understand it.
Eleven datasets designed to test different structural patterns and validation capabilities:
Primary datasets:
Structural validation datasets:
[N] length detection)209 questions are generated dynamically across five categories:
Field retrieval (33%): Direct value lookups or values that can be read straight off a record (including booleans and simple counts such as array lengths)
750003John DoeAggregation (30%): Dataset-level totals and averages plus single-condition filters (counts, sums, min/max comparisons)
1745123.5023Filtering (23%): Multi-condition queries requiring compound logic (AND constraints across fields)
58Structure awareness (12%): Tests format-native structural affordances (TOON's [N] count and {fields}, CSV's header row)
100id, name, email, department, salary, yearsExperience, activeSalesStructural validation (2%): Tests ability to detect incomplete, truncated, or corrupted data using structural metadata
YES (control dataset) or NO (corrupted datasets)[N] length validation and {fields} consistency checking50000 = $50,000, Engineering = engineering, 2025-01-01 = January 1, 2025) without requiring an LLM judge.claude-haiku-4-5-20251001, gemini-3-flash-preview, gpt-5-nano, grok-4-1-fast-non-reasoninggpt-tokenizer with o200k_base encoding (GPT-5 tokenizer)Token counts are measured using the GPT-5 o200k_base tokenizer via gpt-tokenizer. Savings are calculated against formatted JSON (2-space indentation) as the primary baseline, with additional comparisons to compact JSON (minified), YAML, and XML. Actual savings vary by model and tokenizer.
The benchmarks test datasets across different structural patterns (uniform, semi-uniform, nested, deeply nested) to show where TOON excels and where other formats may be better.
<!-- automd:file src="../../benchmarks/results/token-efficiency.md" -->Datasets with nested or semi-uniform structures. CSV excluded as it cannot properly represent these structures.
๐ E-commerce orders with nested structures โ Tabular: 33%
โ
TOON โโโโโโโโโโโโโโโโโโโโ 73,126 tokens
โโ vs JSON (โ33.3%) 109,599 tokens
โโ vs JSON compact (+5.3%) 69,459 tokens
โโ vs YAML (โ14.4%) 85,415 tokens
โโ vs XML (โ40.7%) 123,344 tokens
๐งพ Semi-uniform event logs โ Tabular: 50%
โ
TOON โโโโโโโโโโโโโโโโโโโโ 154,084 tokens
โโ vs JSON (โ15.0%) 181,201 tokens
โโ vs JSON compact (+19.9%) 128,529 tokens
โโ vs YAML (โ0.8%) 155,397 tokens
โโ vs XML (โ25.2%) 205,859 tokens
๐งฉ Deeply nested configuration โ Tabular: 0%
โ
TOON โโโโโโโโโโโโโโโโโโโโ 620 tokens
โโ vs JSON (โ31.9%) 911 tokens
โโ vs JSON compact (+11.1%) 558 tokens
โโ vs YAML (โ6.3%) 662 tokens
โโ vs XML (โ38.2%) 1,003 tokens
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Total โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
TOON โโโโโโโโโโโโโโโโโโโโ 227,830 tokens
โโ vs JSON (โ21.9%) 291,711 tokens
โโ vs JSON compact (+14.7%) 198,546 tokens
โโ vs YAML (โ5.7%) 241,474 tokens
โโ vs XML (โ31.0%) 330,206 tokens
Datasets with flat tabular structures where CSV is applicable.
๐ฅ Uniform employee records โ Tabular: 100%
โ
CSV โโโโโโโโโโโโโโโโโโโโ 47,102 tokens
TOON โโโโโโโโโโโโโโโโโโโโ 49,919 tokens (+6.0% vs CSV)
โโ vs JSON (โ60.7%) 127,063 tokens
โโ vs JSON compact (โ36.9%) 79,059 tokens
โโ vs YAML (โ50.1%) 100,011 tokens
โโ vs XML (โ65.9%) 146,579 tokens
๐ Time-series analytics data โ Tabular: 100%
โ
CSV โโโโโโโโโโโโโโโโโโโโ 8,383 tokens
TOON โโโโโโโโโโโโโโโโโโโโ 9,115 tokens (+8.7% vs CSV)
โโ vs JSON (โ59.0%) 22,245 tokens
โโ vs JSON compact (โ35.9%) 14,211 tokens
โโ vs YAML (โ49.0%) 17,858 tokens
โโ vs XML (โ65.8%) 26,616 tokens
โญ Top 100 GitHub repositories โ Tabular: 100%
โ
CSV โโโโโโโโโโโโโโโโโโโโ 8,512 tokens
TOON โโโโโโโโโโโโโโโโโโโโ 8,744 tokens (+2.7% vs CSV)
โโ vs JSON (โ42.3%) 15,144 tokens
โโ vs JSON compact (โ23.7%) 11,454 tokens
โโ vs YAML (โ33.4%) 13,128 tokens
โโ vs XML (โ48.9%) 17,095 tokens
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Total โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
CSV โโโโโโโโโโโโโโโโโโโโ 63,997 tokens
TOON โโโโโโโโโโโโโโโโโโโโ 67,778 tokens (+5.9% vs CSV)
โโ vs JSON (โ58.8%) 164,452 tokens
โโ vs JSON compact (โ35.3%) 104,724 tokens
โโ vs YAML (โ48.3%) 130,997 tokens
โโ vs XML (โ64.4%) 190,290 tokens
Savings: 13,130 tokens (59.0% reduction vs JSON)
JSON (22,245 tokens):
{
"metrics": [
{
"date": "2025-01-01",
"views": 6138,
"clicks": 174,
"conversions": 12,
"revenue": 2712.49,
"bounceRate": 0.35
},
{
"date": "2025-01-02",
"views": 4616,
"clicks": 274,
"conversions": 34,
"revenue": 9156.29,
"bounceRate": 0.56
},
{
"date": "2025-01-03",
"views": 4460,
"clicks": 143,
"conversions": 8,
"revenue": 1317.98,
"bounceRate": 0.59
},
{
"date": "2025-01-04",
"views": 4740,
"clicks": 125,
"conversions": 13,
"revenue": 2934.77,
"bounceRate": 0.37
},
{
"date": "2025-01-05",
"views": 6428,
"clicks": 369,
"conversions": 19,
"revenue": 1317.24,
"bounceRate": 0.3
}
]
}
TOON (9,115 tokens):
metrics[5]{date,views,clicks,conversions,revenue,bounceRate}:
2025-01-01,6138,174,12,2712.49,0.35
2025-01-02,4616,274,34,9156.29,0.56
2025-01-03,4460,143,8,1317.98,0.59
2025-01-04,4740,125,13,2934.77,0.37
2025-01-05,6428,369,19,1317.24,0.3
Savings: 6,400 tokens (42.3% reduction vs JSON)
JSON (15,144 tokens):
{
"repositories": [
{
"id": 28457823,
"name": "freeCodeCamp",
"repo": "freeCodeCamp/freeCodeCamp",
"description": "freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming,โฆ",
"createdAt": "2014-12-24T17:49:19Z",
"updatedAt": "2025-10-28T11:58:08Z",
"pushedAt": "2025-10-28T10:17:16Z",
"stars": 430886,
"watchers": 8583,
"forks": 42146,
"defaultBranch": "main"
},
{
"id": 132750724,
"name": "build-your-own-x",
"repo": "codecrafters-io/build-your-own-x",
"description": "Master programming by recreating your favorite technologies from scratch.",
"createdAt": "2018-05-09T12:03:18Z",
"updatedAt": "2025-10-28T12:37:11Z",
"pushedAt": "2025-10-10T18:45:01Z",
"stars": 430877,
"watchers": 6332,
"forks": 40453,
"defaultBranch": "master"
},
{
"id": 21737465,
"name": "awesome",
"repo": "sindresorhus/awesome",
"description": "๐ Awesome lists about all kinds of interesting topics",
"createdAt": "2014-07-11T13:42:37Z",
"updatedAt": "2025-10-28T12:40:21Z",
"pushedAt": "2025-10-27T17:57:31Z",
"stars": 410052,
"watchers": 8017,
"forks": 32029,
"defaultBranch": "main"
}
]
}
TOON (8,744 tokens):
repositories[3]{id,name,repo,description,createdAt,updatedAt,pushedAt,stars,watchers,forks,defaultBranch}:
28457823,freeCodeCamp,freeCodeCamp/freeCodeCamp,"freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming,โฆ","2014-12-24T17:49:19Z","2025-10-28T11:58:08Z","2025-10-28T10:17:16Z",430886,8583,42146,main
132750724,build-your-own-x,codecrafters-io/build-your-own-x,Master programming by recreating your favorite technologies from scratch.,"2018-05-09T12:03:18Z","2025-10-28T12:37:11Z","2025-10-10T18:45:01Z",430877,6332,40453,master
21737465,awesome,sindresorhus/awesome,๐ Awesome lists about all kinds of interesting topics,"2014-07-11T13:42:37Z","2025-10-28T12:40:21Z","2025-10-27T17:57:31Z",410052,8017,32029,main