# Groundcheck Instrument Identity Resolver

> Groundcheck Instrument Identity Resolver is a paid API for AI agents from groundcheck.seiche.info, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Maps a financial instrument identifier (ticker, ISIN, CUSIP, SEDOL, FIGI, or name) to canonical FIGI records with provenance attestation via Bloomberg open symbology

## Facts

- Endpoint: POST https://groundcheck.seiche.info/resolve
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/groundcheck-instrument-identity-resolver-b06525c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BL-NQPpxJrIzf6_gE0Hjv

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 groundcheck-instrument-identity-resolver-b06525c9 -d '<json body>'
```

Example prompt: Before I process this trade confirmation, can you resolve 'AAPL' as a ticker to its canonical FIGI record so we know exactly which security we're dealing with — including its security type, market sector, and exchange?

## When to prefer this

Use this endpoint when an AI agent needs to unambiguously identify a financial instrument before acting on a claim, order, or document — especially when provenance (source + retrieval time) must be attached to the answer for auditability. Prefer this over generic search when you need Bloomberg-standard FIGI canonical identity with attested metadata, rather than just name-matching or price data.

## Known failure modes

- Unrecognized or ambiguous identifier returns empty results or low-confidence matches
- Mismatched id_type hint causes lookup failure even for valid identifiers
- Rate limiting or upstream Bloomberg OpenFIGI API unavailability returns 5xx error
- Invalid query string (empty or malformed) returns 400 validation error
- Payment failure via x402 protocol blocks the request before resolution

## How this service works

Attested instrument-identity enrichment for AI agents: map a ticker, ISIN, CUSIP, SEDOL, FIGI, or instrument name to canonical FIGI records (name, security type, market sector, exchange) via Bloomberg open symbology, with provenance (source, retrieval time) attached to every answer. Built for agents that must know WHICH security a claim, order, or document is about before acting on it.

## Output

Returns one or more FIGI-matched records, each containing the canonical instrument name, FIGI identifier, security type, market sector, and exchange, plus provenance metadata including the data source and retrieval timestamp for auditability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Ticker, ISIN, CUSIP, SEDOL, FIGI, or instrument name to resolve"
  },
  "id_type": {
   "enum": [
    "TICKER",
    "ID_ISIN",
    "ID_CUSIP",
    "ID_SEDOL",
    "ID_BB_GLOBAL"
   ],
   "type": "string",
   "description": "Optional; auto-detected from the value's shape when omitted"
  },
  "max_results": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "AAPL",
  "id_type": "TICKER",
  "matched": true,
  "provenance": {
   "url": "https://api.openfigi.com/v3",
   "source": "OpenFIGI (Bloomberg open symbology)",
   "retrieved_at": "2026-07-13T00:00:00+00:00"
  },
  "instruments": [
   {
    "figi": "BBG000B9XRY4",
    "name": "APPLE INC",
    "ticker": "AAPL",
    "exch_code": "US",
    "market_sector": "Equity",
    "security_type": "Common Stock"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/groundcheck-instrument-identity-resolver-b06525c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from groundcheck.seiche.info](https://www.zero.xyz/host/groundcheck.seiche.info/llms.txt)