CelerAPI

21 paid tools for company and LEI research, SEC filings, FX, time zones and OFAC wallet screening.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
99%
Vollständigkeit des Schemas
91%
Qualität der Benennung
98%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'get_historical_fx_rate' description lacks action verbin get_historical_fx_rate

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~13,265Tokens (Tool-Definitionen)
~6.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (10.36% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "celerapi": {
      "url": "https://www.celerapi.com/mcp"
    }
  }
}

Remote-Endpunkte

https://www.celerapi.com/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (21)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_company(query, country_hint, jurisdiction_hint)

Search authoritative company registries by company name to resolve candidate legal entities and registration identifiers. Currently supports the United Kingdom (GB) and Norway (NO), with expanding jurisdiction coverage. Results are public-register evidence, not a KYC or KYB compliance determination. Use this first when the registration identifier is unknown; a country_hint is recommended and omission preserves the GB default. Other country codes are unsupported. Price: $0.0050 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Company or business name to search in the authoritative registry selected by country_hint. Omitting country_hint defaults to GB. Example: Monzo Bank."
    },
    "country_hint": {
      "description": "Optional ISO 3166-1 alpha-2 country code. Gate G1 supports GB and NO; omitted defaults to GB.",
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    },
    "jurisdiction_hint": {
      "description": "Optional sub-jurisdiction. National registries accept 'national'; unsupported values return an explicit error.",
      "type": "string",
      "pattern": "^[a-z0-9-]{2,32}$"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_ids": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "entity_id": {
                "type": "string"
              },
              "legal_name": {
                "type": "string"
              },
              "company_number": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string"
              },
              "registration_number": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "entity_type": {
                "type": "string"
              },
              "registered_address": {
                "type": "object",
                "properties": {
                  "premises": {
                    "type": "string"
                  },
                  "address_line_1": {
                    "type": "string"
                  },
                  "address_line_2": {
                    "type": "string"
                  },
                  "locality": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "care_of": {
                    "type": "string"
                  },
                  "po_box": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "source": {
                "type": "object",
                "properties": {
                  "authority": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  }
                },
                "required": [
                  "authority",
                  "provider"
                ],
                "additionalProperties": false
              },
              "local_identifiers": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string"
                }
              },
              "match_type": {
                "type": "string",
                "enum": [
                  "exact",
                  "prefix",
                  "fuzzy",
                  "provider_ranked",
                  "unknown"
                ]
              },
              "dissolution_date": {
                "type": "string"
              },
              "company_status": {
                "type": "string"
              },
              "company_type": {
                "type": "string"
              },
              "registered_office_address": {
                "type": "object",
                "properties": {
                  "premises": {
                    "type": "string"
                  },
                  "address_line_1": {
                    "type": "string"
                  },
                  "address_line_2": {
                    "type": "string"
                  },
                  "locality": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "care_of": {
                    "type": "string"
                  },
                  "po_box": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "incorporation_date": {
                "type": "string"
              },
              "available_capabilities": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "profile",
                    "officers",
                    "owners",
                    "filings",
                    "insolvency"
                  ]
                }
              }
            },
            "required": [
              "entity_id",
              "legal_name",
              "company_number",
              "jurisdiction",
              "available_capabilities"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_ids",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢search_lei(query, limit)

Find candidate LEIs by legal-entity name in GLEIF's global LEI index. Supply query; optionally limit results. Returns candidate LEIs and matching legal names, jurisdictions and statuses. Select and verify a candidate, then use lookup_lei for its record. Matching is not identity certification; LEI issuance or status is not proof of financial soundness. Price: $0.0051 production USDC via x402 on Base mainnet. Example arguments: {"query":"Apple Inc","limit":5}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_sec_filings(cik, limit)

Find recent SEC EDGAR filing records for financial research, issuer due diligence and regulatory-event checks. Requires cik; if unknown, first use search_sec_company by name/ticker (a separate paid call). Returns recent forms, dates, accession numbers and SEC document URLs; inspect returned forms for 10-K/10-Q. No form filter, complete documents, financial extraction or investment advice. Price: $0.0100 production USDC via x402 on Base mainnet. Example arguments: {"cik":"0000320193","limit":5}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "cik"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_fx_rate(base_currency, quote_currency)

Get a reference exchange rate, not a converted amount: supply base_currency and quote_currency as three-letter ISO codes supported by ECB via Frankfurter. Returns rate, published rate date and provider_code; retrieved_at is fetch time, not rate time. Latest available daily reference data, not a real-time trading feed or executable quote. Price: $0.0010 production USDC via x402 on Base mainnet. Example arguments: {"base_currency":"GBP","quote_currency":"USD"}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "base_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "quote_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    }
  },
  "required": [
    "base_currency",
    "quote_currency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢convert_currency(amount, from_currency, to_currency)

Convert a specified amount using ECB reference rates via Frankfurter. Requires finite amount > 0 and <= 1000000000, from_currency and to_currency (supported three-letter ISO codes). Returns amount, converted_amount, rate and published rate date. One CelerAPI call; get_fx_rate is not a prerequisite. Informational estimate, not trade execution or a real-time quote. Price: $0.0011 production USDC via x402 on Base mainnet. Example arguments: {"amount":500,"from_currency":"GBP","to_currency":"USD"}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000000
    },
    "from_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "to_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    }
  },
  "required": [
    "amount",
    "from_currency",
    "to_currency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_company_profile(company_number)

Retrieve the Companies House profile for a known UK company number, including legal name, registration status, company type, incorporation date, registered office, SIC codes, accounts metadata, confirmation-statement metadata, and available flags. Useful for public-register company verification, onboarding, supplier checks, and corporate research. Price: $0.0053 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "pattern": "^[A-Z0-9]{8}$",
      "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "properties": {
            "entity_id": {
              "type": "string"
            },
            "legal_name": {
              "type": "string"
            },
            "company_number": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string",
              "const": "GB"
            },
            "company_status": {
              "type": "string"
            },
            "company_type": {
              "type": "string"
            },
            "incorporation_date": {
              "type": "string"
            },
            "registered_office_address": {
              "type": "object",
              "properties": {
                "premises": {
                  "type": "string"
                },
                "address_line_1": {
                  "type": "string"
                },
                "address_line_2": {
                  "type": "string"
                },
                "locality": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "care_of": {
                  "type": "string"
                },
                "po_box": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "sic_codes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "accounts": {
              "type": "object",
              "properties": {
                "accounting_reference_date": {
                  "type": "object",
                  "properties": {
                    "day": {
                      "type": "string"
                    },
                    "month": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                },
                "next_accounts_due_on": {
                  "type": "string"
                },
                "next_accounts_period_start_on": {
                  "type": "string"
                },
                "next_accounts_period_end_on": {
                  "type": "string"
                },
                "overdue": {
                  "type": "boolean"
                },
                "last_accounts": {
                  "type": "object",
                  "properties": {
                    "made_up_to": {
                      "type": "string"
                    },
                    "period_start_on": {
                      "type": "string"
                    },
                    "period_end_on": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            },
            "confirmation_statement": {
              "type": "object",
              "properties": {
                "next_due": {
                  "type": "string"
                },
                "next_made_up_to": {
                  "type": "string"
                },
                "overdue": {
                  "type": "boolean"
                },
                "last_made_up_to": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "has_insolvency_history": {
              "type": "boolean"
            },
            "has_charges": {
              "type": "boolean"
            }
          },
          "required": [
            "entity_id",
            "legal_name",
            "company_number",
            "jurisdiction",
            "company_status",
            "company_type",
            "sic_codes"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_company_officers(company_number)

Retrieve directors and other officers recorded for a UK company at Companies House, including roles and appointment or resignation details where available. Public fields may include nationality, occupation, and country of residence. Useful for due diligence, governance research, supplier onboarding, and public-register company verification; officer fields are not independently verified by CelerAPI. Price: $0.0101 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "pattern": "^[A-Z0-9]{8}$",
      "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "officer_role": {
                "type": "string"
              },
              "appointed_on": {
                "type": "string"
              },
              "resigned_on": {
                "type": "string"
              },
              "nationality": {
                "type": "string"
              },
              "occupation": {
                "type": "string"
              },
              "country_of_residence": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "officer_role"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_company_owners(company_number)

Retrieve Persons with Significant Control (PSC) recorded for a UK company at Companies House, including nature of control and available identity information. Useful for company ownership research and KYB-supporting due diligence. PSC information reflects the public register and is not independent verification of beneficial ownership. Price: $0.0102 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "pattern": "^[A-Z0-9]{8}$",
      "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "notified_on": {
                "type": "string"
              },
              "ceased_on": {
                "type": "string"
              },
              "nature_of_control": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "nationality": {
                "type": "string"
              },
              "country_of_residence": {
                "type": "string"
              },
              "identification": {
                "type": "object",
                "properties": {
                  "legal_form": {
                    "type": "string"
                  },
                  "legal_authority": {
                    "type": "string"
                  },
                  "place_registered": {
                    "type": "string"
                  },
                  "registration_number": {
                    "type": "string"
                  },
                  "country_registered": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "kind",
              "nature_of_control"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_company_filings(company_number, limit)

Retrieve recent Companies House filing-history metadata for a known UK company. Records may include accounts, confirmation statements, officer changes, and other filing categories. Useful for corporate research, due diligence, and reviewing recent company changes; this tool does not semantically interpret filing contents. limit defaults to 10 and accepts 1 to 100. Price: $0.0103 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "pattern": "^[A-Z0-9]{8}$",
      "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of recent filing records to return. Optional; defaults to 10 and accepts 1 to 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "filing_date": {
                "type": "string"
              },
              "filing_type": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "category": {
                "type": "string"
              },
              "transaction_id": {
                "type": "string"
              }
            },
            "required": [
              "filing_date",
              "filing_type",
              "description",
              "category"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_company_insolvency(company_number)

Retrieve Companies House insolvency information for a known UK company. The normalized result distinguishes no insolvency information found, insolvency information exists, and lookup or source failure. Useful for supplier checks, counterparty due diligence, and company-risk research. Absence of Companies House insolvency information is not proof of financial health. Price: $0.0054 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "pattern": "^[A-Z0-9]{8}$",
      "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "no_information"
                },
                "has_insolvency_information": {
                  "type": "boolean",
                  "const": false
                },
                "cases": {
                  "minItems": 0,
                  "maxItems": 0,
                  "type": "array",
                  "items": {
                    "not": {}
                  }
                }
              },
              "required": [
                "status",
                "has_insolvency_information",
                "cases"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "information_found"
                },
                "has_insolvency_information": {
                  "type": "boolean",
                  "const": true
                },
                "insolvency_status": {
                  "type": "string"
                },
                "cases": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "case_number": {
                        "type": "string"
                      },
                      "case_type": {
                        "type": "string"
                      },
                      "dates": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            },
                            "date": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "notes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "practitioners": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "role": {
                              "type": "string"
                            },
                            "appointed_on": {
                              "type": "string"
                            },
                            "ceased_to_act_on": {
                              "type": "string"
                            },
                            "addresses": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "premises": {
                                    "type": "string"
                                  },
                                  "address_line_1": {
                                    "type": "string"
                                  },
                                  "address_line_2": {
                                    "type": "string"
                                  },
                                  "locality": {
                                    "type": "string"
                                  },
                                  "region": {
                                    "type": "string"
                                  },
                                  "postal_code": {
                                    "type": "string"
                                  },
                                  "country": {
                                    "type": "string"
                                  },
                                  "care_of": {
                                    "type": "string"
                                  },
                                  "po_box": {
                                    "type": "string"
                                  }
                                },
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "name",
                            "addresses"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "dates",
                      "notes",
                      "practitioners"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "status",
                "has_insolvency_information",
                "cases"
              ],
              "additionalProperties": false
            }
          ]
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_entity_profile(entity_id)

Retrieve normalized authoritative profile information for a resolved legal entity using its stable CelerAPI entity ID. Profile coverage currently includes GB and NO; fields and completeness vary by jurisdiction and source registry. Unsupported capabilities are rejected before payment. Price: $0.0055 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "description": "Stable CelerAPI entity ID returned by search_company. Pass it unchanged."
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "properties": {
            "entity_id": {
              "type": "string"
            },
            "legal_name": {
              "type": "string"
            },
            "registration_number": {
              "type": "string"
            },
            "country": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "entity_type": {
              "type": "string"
            },
            "incorporation_date": {
              "type": "string"
            },
            "registered_address": {
              "type": "object",
              "properties": {
                "premises": {
                  "type": "string"
                },
                "address_line_1": {
                  "type": "string"
                },
                "address_line_2": {
                  "type": "string"
                },
                "locality": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "care_of": {
                  "type": "string"
                },
                "po_box": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "local_identifiers": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string"
              }
            }
          },
          "required": [
            "entity_id",
            "legal_name",
            "registration_number",
            "country",
            "jurisdiction",
            "status",
            "entity_type"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_entity_officers(entity_id)

Retrieve normalized authoritative management or registered-role information for a resolved legal entity where supported by its registry. Coverage currently includes GB; role semantics and availability vary by jurisdiction. Unsupported capabilities are rejected before payment. Price: $0.0104 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "description": "Stable CelerAPI entity ID returned by search_company. Pass it unchanged."
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "role": {
                "type": "string"
              },
              "appointed_at": {
                "type": "string"
              },
              "resigned_at": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "source": {
                "type": "object",
                "properties": {
                  "authority": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  }
                },
                "required": [
                  "authority",
                  "provider"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "name",
              "role"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_entity_owners(entity_id)

Retrieve normalized ownership or control records for a resolved legal entity where an audited authoritative registry supports the capability. Coverage currently includes GB Companies House PSC records only and is not independent beneficial-ownership verification. Unsupported capabilities are rejected before payment. Price: $0.0105 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "description": "Stable CelerAPI entity ID returned by search_company. Pass it unchanged."
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "notified_on": {
                "type": "string"
              },
              "ceased_on": {
                "type": "string"
              },
              "nature_of_control": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "nationality": {
                "type": "string"
              },
              "country_of_residence": {
                "type": "string"
              },
              "identification": {
                "type": "object",
                "properties": {
                  "legal_form": {
                    "type": "string"
                  },
                  "legal_authority": {
                    "type": "string"
                  },
                  "place_registered": {
                    "type": "string"
                  },
                  "registration_number": {
                    "type": "string"
                  },
                  "country_registered": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "kind",
              "nature_of_control"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_entity_filings(entity_id, limit)

Retrieve normalized authoritative filing-history metadata for a resolved legal entity where supported by its registry. Coverage currently includes GB Companies House filings only; no cross-jurisdiction filing equivalence is inferred. Unsupported capabilities are rejected before payment. Price: $0.0106 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "description": "Stable CelerAPI entity ID returned by search_company. Pass it unchanged."
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "filing_date": {
                "type": "string"
              },
              "filing_type": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "category": {
                "type": "string"
              },
              "transaction_id": {
                "type": "string"
              }
            },
            "required": [
              "filing_date",
              "filing_type",
              "description",
              "category"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_entity_insolvency(entity_id)

Retrieve normalized authoritative insolvency information for a resolved legal entity where supported by its registry. Coverage currently includes GB Companies House only; absence of a registry record is not proof of financial health. Unsupported capabilities are rejected before payment. Price: $0.0056 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "description": "Stable CelerAPI entity ID returned by search_company. Pass it unchanged."
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean"
        },
        "entity_id": {
          "type": "string"
        },
        "data": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "no_information"
                },
                "has_insolvency_information": {
                  "type": "boolean",
                  "const": false
                },
                "cases": {
                  "minItems": 0,
                  "maxItems": 0,
                  "type": "array",
                  "items": {
                    "not": {}
                  }
                }
              },
              "required": [
                "status",
                "has_insolvency_information",
                "cases"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "const": "information_found"
                },
                "has_insolvency_information": {
                  "type": "boolean",
                  "const": true
                },
                "insolvency_status": {
                  "type": "string"
                },
                "cases": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "case_number": {
                        "type": "string"
                      },
                      "case_type": {
                        "type": "string"
                      },
                      "dates": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            },
                            "date": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "notes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "practitioners": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "role": {
                              "type": "string"
                            },
                            "appointed_on": {
                              "type": "string"
                            },
                            "ceased_to_act_on": {
                              "type": "string"
                            },
                            "addresses": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "premises": {
                                    "type": "string"
                                  },
                                  "address_line_1": {
                                    "type": "string"
                                  },
                                  "address_line_2": {
                                    "type": "string"
                                  },
                                  "locality": {
                                    "type": "string"
                                  },
                                  "region": {
                                    "type": "string"
                                  },
                                  "postal_code": {
                                    "type": "string"
                                  },
                                  "country": {
                                    "type": "string"
                                  },
                                  "care_of": {
                                    "type": "string"
                                  },
                                  "po_box": {
                                    "type": "string"
                                  }
                                },
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "name",
                            "addresses"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "dates",
                      "notes",
                      "practitioners"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "status",
                "has_insolvency_information",
                "cases"
              ],
              "additionalProperties": false
            }
          ]
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "entity_id",
        "data",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "entity_id": {
          "type": "string"
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "INVALID_INPUT",
                "INVALID_ENTITY_ID",
                "ENTITY_NOT_FOUND",
                "UNSUPPORTED_CAPABILITY",
                "UNSUPPORTED_JURISDICTION",
                "UNSUPPORTED_JURISDICTION_HINT",
                "COMPANY_NOT_FOUND",
                "AUTHENTICATION_FAILURE",
                "RATE_LIMITED",
                "UPSTREAM_UNAVAILABLE",
                "MALFORMED_UPSTREAM_RESPONSE",
                "NETWORK_TIMEOUT",
                "UPSTREAM_TIMEOUT",
                "UPSTREAM_RATE_LIMIT",
                "UNKNOWN_UPSTREAM_ERROR"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "upstream_status": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registry": {
              "type": "string"
            },
            "retrieved_at": {
              "type": "string"
            },
            "freshness": {
              "type": "string",
              "const": "live"
            },
            "authority": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "country": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "jurisdiction",
            "registry",
            "retrieved_at",
            "freshness"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "success",
        "complete",
        "error",
        "provenance",
        "warnings"
      ],
      "additionalProperties": false
    }
  ]
}
🟢get_historical_fx_rate(base_currency, quote_currency, date)

Return the European Central Bank reference rate for a three-letter ISO currency pair on a specified historical date. Use for retrospective reconciliation or analysis; non-business dates may resolve to provider handling rather than an intraday quote. Price: $0.0020 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "base_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "quote_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "base_currency",
    "quote_currency",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢lookup_lei(lei)

Retrieve normalized public legal-entity reference data from GLEIF for an exact 20-character LEI. Use to resolve a known identifier to its legal name, status, jurisdiction, and public addresses; records reflect LEI submissions and are not independent verification. Price: $0.0052 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string",
      "pattern": "^[A-Z0-9]{20}$"
    }
  },
  "required": [
    "lei"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_lei_relationships(lei)

Retrieve normalized direct and ultimate accounting-consolidation parent identifiers reported to GLEIF for an exact LEI. Use for public corporate-hierarchy research; reporting exceptions are returned as warnings and absence is not proof that no ownership relationship exists. Price: $0.0057 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string",
      "pattern": "^[A-Z0-9]{20}$"
    }
  },
  "required": [
    "lei"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢search_sec_company(query, limit)

Search the official SEC company ticker reference data by issuer name, ticker, or CIK and return bounded normalized candidates. When a CIK is unknown, select a matching candidate and pass its cik to get_sec_filings in a separate paid request. This reference list is not a complete registry of every U.S. legal entity. Price: $0.0058 production USDC via x402 on Base mainnet. Example arguments: {"query":"Apple","limit":10}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_timezone(time_zone, at)

Resolve an IANA time-zone identifier and convert an optional ISO timestamp using the Worker runtime time-zone database. Use for deterministic local-time and UTC-offset calculations; government rules can change and the exact embedded tzdb release is runtime-controlled. Price: $0.0012 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "time_zone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    }
  },
  "required": [
    "time_zone"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "complete": {
      "type": "boolean"
    }
  },
  "required": [
    "success",
    "complete"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢screen_wallet(address, network, authorities)

Checks whether an exact digital-currency address appears in the authoritative sanctions datasets currently supported by CelerAPI. This is exact sanctions-list membership lookup, not blockchain-risk analysis or a compliance determination. Price: $0.0060 production USDC via x402 on Base mainnet.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Digital-currency address to check. It is structurally validated for the required network and is not logged or persisted by CelerAPI."
    },
    "network": {
      "type": "string",
      "enum": [
        "bitcoin",
        "bitcoin-cash",
        "bitcoin-gold",
        "bitcoin-sv",
        "bnb-smart-chain",
        "dash",
        "ethereum",
        "ethereum-classic",
        "litecoin",
        "monero",
        "solana",
        "tron",
        "verge",
        "xrpl",
        "zcash"
      ],
      "description": "Canonical network identifier. Required; CelerAPI never guesses a wallet network."
    },
    "authorities": {
      "description": "Optional active authority selection. Omission checks all active supported authorities, currently US_OFAC.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "const": "US_OFAC"
      }
    }
  },
  "required": [
    "address",
    "network"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "complete": {
          "type": "boolean",
          "const": true
        },
        "result": {
          "type": "string",
          "enum": [
            "MATCH",
            "NO_MATCH_FOUND"
          ]
        },
        "network": {
          "type": "string"
        },
        "matches": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authority": {
                "type": "string"
              },
              "dataset": {
                "type": "string"
              },
              "record_id": {
                "type": "string"
              },
              "primary_name": {
                "type": "string"
              },
              "programs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "identifier_type": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              }
            },
            "required": [
              "authority",
              "dataset",
              "record_id",
              "primary_name",
              "programs",
              "identifier_type",
              "source_url"
            ],
            "additionalProperties": false
          }
        },
        "sources_checked": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "freshness": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authority": {
                "type": "string"
              },
              "dataset": {
                "type": "string"
              },
              "dataset_version": {
                "type": "string"
              },
              "data_as_of": {
                "type": "string"
              },
              "last_verified_at": {
                "type": "string"
              },
              "state": {
                "type": "string",
                "enum": [
                  "HEALTHY",
                  "STALE",
                  "AT_RISK",
                  "FAILED"
                ]
              }
            },
            "required": [
              "authority",
              "dataset",
              "dataset_version",
              "data_as_of",
              "last_verified_at",
              "state"
            ],
            "additionalProperties": false
          }
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "const": "SANCTIONS_DATA_STALE"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ],
            "additionalProperties": false
          }
        },
        "provenance": {
          "type": "object",
          "properties": {
            "authority": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "source_url": {
              "type": "string"
            },
            "matching": {
              "type": "string",
              "const": "exact_identifier"
            }
          },
          "required": [
            "authority",
            "source",
            "source_url",
            "matching"
          ],
          "additionalProperties": false
        },
        "disclaimer": {
          "type": "string",
          "const": "Exact authoritative sanctions-list identifier lookup. This response does not constitute legal, sanctions, AML, or compliance advice or a determination that a wallet is safe or compliant."
        }
      },
      "required": [
        "success",
        "complete",
        "result",
        "network",
        "matches",
        "sources_checked",
        "freshness",
        "warnings",
        "provenance",
        "disclaimer"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "complete": {
          "type": "boolean",
          "const": false
        },
        "result": {
          "type": "string",
          "const": "UNAVAILABLE"
        },
        "network": {
          "type": "string"
        },
        "sources_checked": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "freshness": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authority": {
                "type": "string"
              },
              "dataset": {
                "type": "string"
              },
              "dataset_version": {
                "type": "string"
              },
              "data_as_of": {
                "type": "string"
              },
              "last_verified_at": {
                "type": "string"
              },
              "state": {
                "type": "string",
                "enum": [
                  "HEALTHY",
                  "STALE",
                  "AT_RISK",
                  "FAILED"
                ]
              }
            },
            "required": [
              "authority",
              "dataset",
              "dataset_version",
              "data_as_of",
              "last_verified_at",
              "state"
            ],
            "additionalProperties": false
          }
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ],
            "additionalProperties": false
          }
        },
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "disclaimer": {
          "type": "string",
          "const": "Exact authoritative sanctions-list identifier lookup. This response does not constitute legal, sanctions, AML, or compliance advice or a determination that a wallet is safe or compliant."
        }
      },
      "required": [
        "success",
        "complete",
        "result",
        "sources_checked",
        "freshness",
        "warnings",
        "error",
        "disclaimer"
      ],
      "additionalProperties": false
    }
  ]
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet21 Tools