API Reference

SEC Filing Intelligence API — semantic search & AI-powered research

Base URL

https://api.signal-x.app

Authentication

All requests require an API key via the Authorization header. API access requires Premium plan or above.

Authorization: Bearer sk_live_your_api_key

Generate API keys in Settings → API.

Endpoints

POST

/v1/chat

1 credit

AI research query — multi-tool analysis with citations

POST

/v1/search

0.2 credits

Semantic filing search — vector similarity with bullet summary

GET

/v1/balance

Check monthly credit usage and remaining quota

GET

/v1/usage

View recent API request logs (last 30 days)

POST

/v1/chat

1 credit

Send a natural language research question. The agent selects from 19 specialized tools (financials, insider trades, fund holdings, filing text, semantic search, etc.) to build a comprehensive answer.

Request Body

{
  "message": "What are Tesla's latest insider trades?",
  "language": "en"    // "en" | "ko"
}

Response

{
  "answer": "Here are Tesla's recent insider trades...",
  "citations": [
    {
      "cik": "1318605",
      "company_name": "Tesla Inc",
      "form_type": "4",
      "filing_date": "2025-01-15"
    }
  ],
  "tool_calls": [
    { "tool": "get_insider_trades", "input": { "issuer_cik": "1318605" } }
  ],
  "usage": {
    "credits_used": 1,
    "credits_remaining": 499
  }
}

Examples

curl -X POST https://api.signal-x.app/v1/chat \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "What are Apple\'s latest financials?", "language": "en"}'

POST

/v1/search

0.2 credits

Lightweight semantic search over SEC filing embeddings. Returns matched passages with a brief AI summary. No multi-tool orchestration — fast and cost-effective for building your own pipelines.

Request Body

{
  "query": "tariff impact on supply chain costs",
  "ticker": "TSLA",           // optional — filter by ticker
  "cik": "1318605",            // optional — filter by CIK
  "form_type": "10-K",        // optional — "10-K", "10-Q", "8-K", etc.
  "section_name": "risk_factors",  // optional
  "date_from": "2025-01-01",  // optional — ISO date
  "date_to": "2026-03-21",    // optional — ISO date
  "limit": 5                  // optional — max results (default: 5)
}

Response

{
  "summary": "## Key Findings\n\n- GE HealthCare: 2025 U.S. tariffs reduced profitability...\n\n## Sources\n1. GE HealthCare | 10-K | 2026-02-04",
  "results": [
    {
      "company_name": "GE HealthCare",
      "cik": "1932393",
      "form_type": "10-K",
      "filing_date": "2026-02-04",
      "accession_number": "0001932393-26-000007",
      "section_name": "risk_factors",
      "similarity": 0.5549,
      "source_type": "summary",
      "excerpt": "US tariffs on global imports in 2025 materially reduced profitability..."
    }
  ],
  "usage": {
    "credits_used": 0.2,
    "credits_remaining": 494.8
  }
}

Examples

curl -X POST https://api.signal-x.app/v1/search \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "AI related risks", "form_type": "10-K", "limit": 5}'

Query Examples

/v1/chat has access to 19 specialized tools. /v1/search performs vector similarity search only.

Category	Example Query	Endpoint
Financials	"What are Apple's revenue and EPS trends over the last 5 years?"	chat
Insider Trading	"Which CEOs bought the most shares in the last 30 days?"	chat
Fund Holdings	"Which institutional funds hold NVIDIA? Compare their positions."	chat
8-K Events	"What material events has Microsoft reported this year?"	chat
Risk Analysis	"What do companies say about tariff risks in recent 10-K filings?"	search
Filing Text	"Find all mentions of AI strategy in semiconductor company filings"	search
ESG / Climate	"Climate change disclosure in recent annual reports"	search
Cross-Analysis	"Compare insider trading sentiment across the S&P 500 this quarter."	chat

GET

/v1/balance

Check your monthly credit usage and remaining quota.

Response

{
  "credits_used": 5.6,
  "credits_remaining": 494.4,
  "credits_limit": 500,
  "breakdown": {
    "research_queries": 5,
    "api_credits": 0.6
  }
}

GET

/v1/usage

View recent API request logs. Optional ?days=30 parameter (default: 30).

Response

{
  "requests": [
    {
      "request_id": "req_abc123",
      "timestamp": "2026-03-20T14:30:00Z",
      "endpoint": "/v1/search",
      "tokens": 536,
      "credits_used": 0.2,
      "duration_ms": 3200
    }
  ],
  "total_count": 60
}

Pricing

Endpoint	Cost per request	Description
/v1/chat	1.0 credit	Full AI research with multi-tool analysis
/v1/search	0.2 credits	Semantic filing search with brief summary

Plan	Credits / Month	Price
Premium	500	$79/mo
Business	5,000	$500/mo
Enterprise	10,000	$1,000/mo

Research queries (web UI) and API requests share the same monthly credit pool. Usage resets on the 1st of each month (UTC).

Rate Limits

All plans: 60 requests per minute.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Daily-Limit: 10000
X-RateLimit-Daily-Remaining: 9994

When rate limited, the API returns 429 Too Many Requests with a Retry-After header.

Error Codes

Code	Description
401	Invalid or missing API key
402	Monthly credit limit reached — upgrade plan
403	API access requires Premium plan or above
429	Rate limit exceeded — wait and retry
500	Internal server error

Build on SEC filing intelligence

Semantic search across 22K+ embedded filing sections. AI-powered research with 19 specialized tools.