# Vextorium Number & Amount Extractor

> Vextorium Number & Amount Extractor is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Extracts and normalizes all numbers, currency amounts, percentages, and multipliers from free-form text, returning structured values with per-currency totals.

## Facts

- Endpoint: POST https://api.vextorium.com/extraer-numeros-texto-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-number-amount-extractor-b66012a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zvHGp1kFCOrCXRvVzPtiL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-number-amount-extractor-b66012a9 -d '<json body>'
```

Example prompt: Can you extract all the numbers and currency amounts from this text and give me totals per currency — it mixes euros and USDC: 'Invoice total: €1.250,00, plus 250 USDC fee and a 5% discount, with a 2x multiplier applied.'

## When to prefer this

Choose this endpoint when you need to extract and normalize financial figures from unstructured text that may mix currencies (fiat and crypto), use European or American number formatting, or include multipliers like 'k', 'million', or 'bn'. It is superior to generic regex approaches because it handles format ambiguity, normalizes multipliers, and aggregates totals per currency automatically. Ideal for processing invoices, financial reports, chat messages, or DeFi transaction descriptions.

## Known failure modes

- Missing 'texto' field returns a validation error
- Ambiguous decimal separator with conflicting formats may cause misdetection if 'auto' mode cannot resolve
- Very long texts may produce incomplete extractions
- Non-standard currency symbols not in the known set may be ignored or misclassified
- Text with no numeric content returns empty arrays

## How this service works

Extract and normalize every number in a text: amounts with currency (€, $, USDC, BTC...), percentages, multipliers (k, million, bn) and plain figures, understanding both 1.234,56 and 1,234.56, with totals per currency.

## Output

Returns a JSON object with: an array of all raw numbers found, an array of currency amount objects (each with original text, normalized numeric value, and currency code), an array of percentage objects (text and numeric value), a per-currency sum map (e.g. {USD: 4950, USDC: 250, BTC: 0.05}), and the detected decimal separator used in the input.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "texto"
     ],
     "properties": {
      "texto": {
       "type": "string"
      },
      "decimal": {
       "enum": [
        "auto",
        ",",
        "."
       ],
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "numeros": {
       "type": [
        "array",
        "null"
       ],
       "items": {}
      },
      "importes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "texto": {
          "type": [
           "null",
           "string"
          ]
         },
         "valor": {
          "type": [
           "null",
           "number"
          ]
         },
         "moneda": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "porcentajes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "texto": {
          "type": [
           "string",
           "null"
          ]
         },
         "valor": {
          "type": [
           "number",
           "null"
          ]
         }
        }
       }
      },
      "suma_por_moneda": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "BTC": {
         "type": [
          "number",
          "null"
         ]
        },
        "USD": {
         "type": [
          "number",
          "null"
         ]
        },
        "USDC": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "numeros": [],
  "importes": [
   {
    "texto": "$1,234.56 million",
    "valor": 1234560000,
    "moneda": "USD"
   },
   {
    "texto": "250 USDC",
    "valor": 250,
    "moneda": "USDC"
   },
   {
    "texto": "0.05 BTC",
    "valor": 0.05,
    "moneda": "BTC"
   }
  ],
  "porcentajes": [
   {
    "texto": "15%",
    "valor": 15
   }
  ],
  "suma_por_moneda": {
   "BTC": 0.05,
   "USD": 1234560000,
   "USDC": 250
  },
  "separador_decimal": "."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-number-amount-extractor-b66012a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)