# ByShovel Data Quote API

> ByShovel Data Quote API is a paid API for AI agents from byshovel.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Requests a price quote for acquiring specialized public dataset records from ByShovel's AI research studio (MSHA mining incidents, OSHA safety records, COMEX/LME metals data)

## Facts

- Endpoint: GET https://byshovel.com/api/x402/quote
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/byshovel-data-quote-api-02b7e4f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t3KCwMC0UZrjazz3bVOFV

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 byshovel-data-quote-api-02b7e4f8
```

Example prompt: Can you get me a price quote from ByShovel for their OSHA workplace safety records dataset?

## When to prefer this

Use this endpoint when you need to obtain pricing or availability information for specialized structured public datasets — particularly MSHA mining incidents, OSHA workplace safety records, or COMEX/LME precious metals data — before committing to a full data purchase. Prefer this over general data brokers when you need obscure, pre-organized public regulatory or commodities data that isn't available elsewhere in structured form.

## Known failure modes

- Missing or malformed 'properties' parameter returns an error or unclear quote
- Payment of 0.05 USDC via x402 protocol not completed results in 402 response
- Requested dataset type not available returns no quote
- API downtime or timeout yields no response

## How this service works

Submit a project to ByShovel for a custom research / data-acquisition quote. Lands in the same intake queue as the web form.

## Output

A JSON response confirming the quote request was received, with ok:true and a message, potentially including pricing or dataset availability details for the requested data properties.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "message": "Quote request received."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/byshovel-data-quote-api-02b7e4f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from byshovel.com](https://www.zero.xyz/host/byshovel.com/llms.txt)