# Jintel

> Jintel is a paid GraphQL intelligence API for financial data, news, risk screening, and web research. Jintel aggregates many upstream public-domain and licensed providers behind one unified entity-centric schema with per-entity sub-graphs for market, risk, regulatory, corporate, technicals, derivatives, news, research, sentiment, financials, executives, institutional holdings, ownership, analyst consensus, clinical trials, FDA events, litigation, government contracts, subsidiaries, and supply-chain relationships.

For agents doing market research, compliance screening, due-diligence on counterparties, or quantitative analysis, Jintel is a single endpoint that replaces stitching together a market-data feed, SEC EDGAR for filings, OFAC for sanctions, OECD/FRED for macro, plus a separate news provider and alt-data sources. For developers building fintech products, agentic copilots, or research notebooks, Jintel is one GraphQL schema, one API key (or one wallet for x402), and one bill instead of a dozen vendor contracts. Use Jintel when you need typed, batched, cache-deduplicated finance data — quotes, filings, sanctions hits, macro series, technicals — in a shape an LLM can reason over.

Two access paths:
- **API key (humans / backend / SDK)** — Monthly plan billing. `Authorization: Bearer jk_live_…`
- **x402 pay-per-query (agents)** — No signup. Wallet signs each GraphQL request; USDC settles on Base mainnet. Discoverable via the CDP Bazaar / agentic.market.

## Get started

- **1. Mint an API key** — Google OAuth at https://jintel.ai/auth/google (humans) or wallet sign-in at https://api.jintel.ai/auth/siwx/verify (agents).
- **2. Test a free query** — `POST https://api.jintel.ai/api/graphql` with `Authorization: Bearer jk_live_…` and body `{ "query": "{ quotes(tickers: [\"AAPL\"]) { price } }" }`.
- **3. Wire up a client** — `@yojinhq/jintel-client` (TS), `@yojinhq/jintel-cli` (CLI), `@yojinhq/jintel-mcp` (MCP for Claude / Cursor / Continue), or call the OpenAPI directly. See https://docs.jintel.ai/integrations.
- **4. Pick a plan** — Free covers evaluation; upgrade to Pro ($49/mo) above 500k credits/month or 60 req/min. Any plan can top up with x402 USDC for non-expiring credits.
- **5. Monitor usage** — `GET https://api.jintel.ai/api/v1/usage` returns aggregated daily counts; `extensions.cost` reports per-query credit cost when `x-jintel-debug: true` is set.

## Developer endpoints

- [GraphQL endpoint](https://api.jintel.ai/api/graphql): The Jintel GraphQL API — `POST` queries here with `Authorization: Bearer …` or an x402 `X-PAYMENT` header
- [Agent-mode view](https://www.jintel.ai/?mode=agent): Machine-readable homepage with endpoints, auth modes, capabilities, and discovery URLs — text/html or JSON via Accept header
- [GraphiQL explorer](https://api.jintel.ai/graphiql): Live schema introspection and query playground (free, no auth)
- [OpenAPI spec](https://api.jintel.ai/openapi.json): AgentCash / agentic.market discovery descriptor — advertises `POST /api/graphql` as the agent-callable surface
- [.well-known x402 manifest](https://api.jintel.ai/.well-known/x402): x402 discovery manifest for indexers (CDP Bazaar, agentic.market)
- [MCP server](https://api.jintel.ai/mcp): Hosted Model Context Protocol server (Streamable HTTP transport) — drop-in tool surface for Claude, Cursor, and any MCP-compatible agent
- [MCP discovery descriptor](https://api.jintel.ai/.well-known/mcp.json): Machine-readable MCP server descriptor for agent registries
- [MCP server card](https://api.jintel.ai/.well-known/mcp/server-card.json): Full tool catalog with input schemas — preview every Jintel tool before opening a transport connection
- [OAuth protected resource metadata](https://api.jintel.ai/.well-known/oauth-protected-resource): RFC 9728 — declares the GraphQL endpoint as the protected resource and lists the authorization server
- [OAuth authorization server metadata](https://api.jintel.ai/.well-known/oauth-authorization-server): RFC 8414 — declares Jintel's OAuth authorization server, advertises PKCE S256 support for MCP clients
- [NLWeb Schema Map](https://www.jintel.ai/schema-map.xml): Index of structured data feeds (llms.txt, OpenAPI, MCP descriptors, x402 manifest) for NLWeb-aware agents and orank/agentic.market scanners

## Docs

- [Introduction](https://docs.jintel.ai/): What Jintel is and who Jintel is for
- [Quickstart](https://docs.jintel.ai/quickstart): First Jintel request in under a minute
- [Authentication](https://docs.jintel.ai/authentication): API key bearer auth
- [Agents & x402](https://docs.jintel.ai/agents): Pay-per-query for autonomous agents
- [Sub-graphs](https://docs.jintel.ai/concepts/sub-graphs): Nested entity data in one query
- [Batching](https://docs.jintel.ai/concepts/batching): `entitiesByTickers` for bulk enrichment
- [Filtering](https://docs.jintel.ai/concepts/filtering): `ArrayFilterInput` for date / limit / sort

## Use cases

- [Financial data API for AI agents](https://docs.jintel.ai/use-cases/financial-data-api-for-ai-agents): One GraphQL endpoint replacing a market-data feed + SEC EDGAR + OFAC + macro stitching
- [Best financial data API for AI agents — Jintel vs Finnhub, FMP, Alpha Vantage, Polygon](https://docs.jintel.ai/use-cases/best-financial-data-api-for-ai-agents): Capability comparison + migration notes
- [Market research with AI agents](https://docs.jintel.ai/use-cases/market-research-with-ai-agents): Bull / bear case generation in a single query
- [Due diligence on counterparties](https://docs.jintel.ai/use-cases/due-diligence-on-counterparties): Sanctions, litigation, FDA events, contracts, ownership in one fan-out
- [Sanctions screening for AI agents](https://docs.jintel.ai/use-cases/sanctions-screening-for-ai-agents): OFAC SDN screening surfaced as a GraphQL field and an MCP tool
- [Portfolio copilot](https://docs.jintel.ai/use-cases/portfolio-copilot): LLM portfolio assistant on batched quotes, history, and news

## Data surfaces

- [Market Data](https://docs.jintel.ai/data/market-data): Quotes, fundamentals, financial statements, price history
- [Regulatory Filings](https://docs.jintel.ai/data/regulatory-filings): Corporate filings — 10-K, 10-Q, 8-K, Form 4, 13F, Exhibit 21
- [Sanctions](https://docs.jintel.ai/data/sanctions): Name-based sanctions-list lookup (public-data convenience, not compliance-grade)
- [Institutional Holdings](https://docs.jintel.ai/data/institutional): 13F holdings and top holders
- [Short Interest](https://docs.jintel.ai/data/short-interest): Short interest by security
- [Campaign Finance](https://docs.jintel.ai/data/campaign-finance): US PAC / committee lookup
- [Economics](https://docs.jintel.ai/data/economics): GDP, CPI, interest rates, balance of payments, US macro time series
- [Technicals](https://docs.jintel.ai/data/technicals): RSI, MACD, Bollinger Bands, EMA, SMA, ATR, VWMA, MFI
- [News](https://docs.jintel.ai/data/news): Financial news articles and social sentiment
- [Alt Data](https://docs.jintel.ai/data/alt-data): Clinical trials, FDA events, federal litigation, government contracts
- [Supply Chain](https://docs.jintel.ai/data/supply-chain): Subsidiaries, segment revenue concentration, relationships

## SDKs & integrations

- [TypeScript SDK](https://docs.jintel.ai/sdk/typescript): `@yojinhq/jintel-client`
- [CLI](https://docs.jintel.ai/sdk/cli): `@yojinhq/jintel-cli`
- [Claude MCP plugin](https://docs.jintel.ai/sdk/mcp): One install for Claude Code (`YojinHQ/jintel-sdk`)
- [Install Jintel in your AI tools](https://docs.jintel.ai/integrations): Wiring Jintel into Claude Desktop, Cursor, Continue, and other MCP-aware clients

## Reference

- [Rate limits](https://docs.jintel.ai/reference/rate-limits): Per-plan request ceilings
- [Errors](https://docs.jintel.ai/reference/errors): GraphQL error codes (including `CREDITS_EXHAUSTED` → HTTP 402)
- [Support](https://docs.jintel.ai/reference/support): support@jintel.ai

## Optional

- [Pricing](https://www.jintel.ai/pricing): Plans and monthly request volumes
- [GraphiQL](https://api.jintel.ai/graphiql): Live schema introspection and query playground
- [OpenAPI](https://api.jintel.ai/openapi.json): AgentCash discovery spec for agent directories — advertises `POST /api/graphql` (AgentCash, x402 Bazaar, agentic.market)