Verify a Figure
verify_figureCheck that a number you are about to state appears in a filing, however it is written.
Every number is compared as its digits alone (separators, decimal point, sign, $ and % dropped, zeros trimmed): "416,161", "416.161" and "416,161,000" are all 416161. Your figure must be one of the filing's numbers times a power of ten, allowing for rounding to the digits you give: "$416.2 billion" matches 416,161 (in millions), "75%" matches "75.0 %". Searches every document in the filing (main document and exhibits) unless filename is given. Candidates are ranked by exactness and by your label's words appearing in the number's row label or lead-in text.
Returns found, match_count, and up to 10 matches, each with its document, label, context and a highlight_url that marks that exact number in the beatandraise.com viewer. Matching ignores magnitude, so confirm each candidate's label, period and scale from its context, then cite its highlight_url. found=false means no number in the filing has those digits: do not attribute the figure to the filing. If you calculated it (a growth rate, a margin), say so and cite the inputs instead. found=null with checked=false means nothing was checked, which says nothing about the figure: a structured XML form (Form 3/4/5, 144, D, 13F) has no text to check, so read its values with get_document and cite that; the note says what to do.
Args: cik: CIK of the filer (e.g. "0000320193") accession_number: SEC accession number value: The figure as you would state it (e.g. "$416.2 billion", "75.0%", "-1,234"). A value with one significant digit ("$10.00", "20,000,000") only matches numbers written exactly the same way; "$2 million" is too vague to check. label: What the figure is (e.g. "total net sales", "GAAP gross margin"). Used for ranking. filename: Optional single document to check instead of the whole filing
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cik": "<cik>",
"accession_number": "<accession_number>",
"value": "<value>"
},
"name": "verify_figure"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | ||
| label | No | ||
| value | Yes | ||
| filename | No | ||
| accession_number | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||