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 credits. Purchase credits in API Console.

Authorization: Bearer sk_live_your_api_key

Generate API keys in API Console.

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 your prepaid credit balance and auto-recharge status

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, just fast and cost-effective search 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 prepaid credit balance. Credits are purchased in packs and deplete as you make requests. There is no monthly quota or reset.

Response

{
  "credits_remaining": 494.4,
  "balance_usd": 49.44,
  "credits_total_purchased": 500,
  "auto_recharge": {
    "enabled": true,
    "threshold_usd": 5,
    "amount_usd": 10
  }
}

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

Endpoint	Credits	Price
/v1/chat	1+ per 10K tokens	$0.10/credit
/v1/search	0.2 (fixed)	$0.02/call

Minimum purchase: $5 (50 credits). No subscription required. Auto-recharge available. Purchase credits in API Console.

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	Insufficient credits. Purchase more at Settings
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.