ECONALK API

OPENAPI 1.0.0 · INTERACTIVE

Try the API

Call the live API from this page with your own key. Every request runs from your browser against the same endpoints your server code uses.

Raw openapi.jsonField referenceGet API key

Console requests are ordinary API calls: they consume your plan's rate limit and monthly quota. Copied cURL commands reference $ECONALK_API_KEY instead of the raw key, so snippets stay safe to share.

Send API key as a Bearer token. Create or rotate keys at ECONALK Developers.

Base URLhttps://api.econalk.com
Rate remaining
—
Month remaining
—
Last request ID
—

Articles

Licensed ECONALK editorial content.

GET/v1/articlesList articlesarticles:read

Returns licensed ECONALK editorial fields. Rights metadata controls attribution and reuse; provider market snapshots are excluded. Snapshot generation and latest published article are each no more than 7 days old.

Page size. Defaults to 20; maximum 100. default=20, min=1, max=100

Opaque cursor bound to one immutable response snapshot. minLength=1, maxLength=2048

enum=en-US | ko-KR | ja-JP | zh-CN

minLength=1, maxLength=80

Requesthttps://api.econalk.com/v1/articles
Field referenceReturns ArticleListEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503
GET/v1/articles/{slug}Get articlearticles:read

Returns one licensed ECONALK article with explicit rights and source attribution metadata. Snapshot generation and latest published article are each no more than 7 days old.

Canonical URL-safe resource slug. minLength=1, maxLength=200, pattern=^[a-z0-9]+(?:-[a-z0-9]+)*$

Requesthttps://api.econalk.com/v1/articles/{slug}
Field referenceReturns ArticleEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503

Economic Calendar

Curated macroeconomic events.

GET/v1/economic-calendarList economic calendar eventscalendar:read

Returns ECONALK-curated events only. License and attribution are explicit; raw upstream payloads and provider identifiers are excluded. verifiedAt is no more than 100 days old, and coverageThrough extends at least 30 days beyond snapshot generation.

Inclusive start date. Combined range may not exceed 93 days. format=date, pattern=^\d{4}-\d{2}-\d{2}$

Inclusive end date. Combined range may not exceed 93 days. format=date, pattern=^\d{4}-\d{2}-\d{2}$

enum=low | medium | high

minLength=2, maxLength=2, pattern=^[A-Z]{2}$

Page size. Defaults to 20; maximum 100. default=20, min=1, max=100

Opaque cursor bound to one immutable response snapshot. minLength=1, maxLength=2048

Requesthttps://api.econalk.com/v1/economic-calendar
Field referenceReturns EconomicCalendarListEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503

Smart Money

SEC filing facts and ECONALK-derived snapshot metrics.

GET/v1/smart-money/investorsList Smart Money investorssmart-money:read

Returns SEC filing facts plus ECONALK snapshot metrics. Snapshot generation is no more than 14 days old; each filing-quarter end is no more than 180 days old. Each upstream snapshot is capped to the largest 250 filing rows. Reported values are not AUM and do not represent full-portfolio value. No live quotes, security identifiers, or licensed market-vendor fields are exposed.

Page size. Defaults to 20; maximum 100. default=20, min=1, max=100

Opaque cursor bound to one immutable response snapshot. minLength=1, maxLength=2048

minLength=1, maxLength=80

Requesthttps://api.econalk.com/v1/smart-money/investors
Field referenceReturns SmartMoneyInvestorListEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503
GET/v1/smart-money/investors/{slug}Get Smart Money investorsmart-money:read

Returns one SEC filing snapshot and issuer-name positions derived by ECONALK. Snapshot generation is no more than 14 days old; the filing-quarter end is no more than 180 days old. Each upstream snapshot is capped to the largest 250 filing rows. Reported values are not AUM and do not represent full-portfolio value.

Canonical URL-safe resource slug. minLength=1, maxLength=160, pattern=^[a-z0-9]+(?:-[a-z0-9]+)*$

Requesthttps://api.econalk.com/v1/smart-money/investors/{slug}
Field referenceReturns SmartMoneyInvestorDetailEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503
GET/v1/smart-money/consensusList Smart Money consensussmart-money:read

Returns issuer-name consensus aggregated from SEC filing snapshots by ECONALK. Snapshot generation is no more than 14 days old; filing-quarter ends are no more than 180 days old. Inputs are capped to the largest 250 filing rows per investor. Reported values are not AUM and do not represent full-portfolio value.

Page size. Defaults to 10; maximum 10. Every encoded response is independently capped at 512 KiB. default=10, min=1, max=10

Opaque cursor bound to one immutable response snapshot. minLength=1, maxLength=2048

Requesthttps://api.econalk.com/v1/smart-money/consensus
Field referenceReturns SmartMoneyConsensusListEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503
GET/v1/smart-money/tradesList Smart Money tradessmart-money:read

Returns query-complete quarter-over-quarter SEC filing changes using issuer names. Snapshot generation is no more than 14 days old; filing-quarter ends are no more than 180 days old. Current positions are limited to the largest 250 filing rows per investor; historical sold rows are retained separately, so change-row counts can exceed 250. Reported-value changes are not transaction cash flow. Exchange symbols, CUSIPs, and sector-vendor fields are excluded.

Page size. Defaults to 20; maximum 100. default=20, min=1, max=100

Opaque cursor bound to one immutable response snapshot. minLength=1, maxLength=2048

enum=new | added | trimmed | sold

minLength=1, maxLength=160

Requesthttps://api.econalk.com/v1/smart-money/trades
Field referenceReturns SmartMoneyTradeListEnvelope · documented statuses 200, 400, 401, 403, 404, 429, 500, 503

Response headers

X-RateLimit-Limit
Request limit for current rolling window.
X-RateLimit-Remaining
Requests remaining in current rolling window.
X-RateLimit-Reset
UTC Unix timestamp when rolling rate window resets.
X-Quota-Limit
Requests allowed in current monthly quota period.
X-Quota-Remaining
Requests remaining in current monthly quota period.
X-Quota-Reset
UTC Unix timestamp when monthly quota resets.
X-Request-Id
Stable request identifier echoed in response body metadata or errors.

Error codes

invalid_request
400
invalid_cursor
400
invalid_api_key
401
insufficient_scope
403
not_found
404
rate_limited
429
quota_exceeded
429
internal_error
500
snapshot_unavailable
503

Every non-200 body uses the canonical ErrorEnvelope. Details and remedies live in the error catalog.

English

Call the live API from this page with your own key. Every request runs from your browser against the same endpoints your server code uses.

  1. Paste an ECONALK API key. It never leaves this browser tab and is never written to disk.
  2. Fill the parameters. Values are validated against the OpenAPI schema before a request is sent.
  3. Send, then read the status, quota headers, and JSON body exactly as your client receives them.

Console requests are ordinary API calls: they consume your plan's rate limit and monthly quota.

Copied cURL commands reference $ECONALK_API_KEY instead of the raw key, so snippets stay safe to share.

한국어

이 페이지에서 본인 키로 실제 API를 호출할 수 있습니다. 모든 요청은 브라우저에서 서버 코드와 동일한 엔드포인트로 직접 전송됩니다.

  1. ECONALK API 키를 붙여 넣으세요. 키는 이 브라우저 탭을 벗어나지 않으며 디스크에 저장되지 않습니다.
  2. 파라미터를 입력하세요. 요청 전에 OpenAPI 스키마 기준으로 값을 검증합니다.
  3. 전송하면 상태 코드, 사용량 헤더, JSON 본문을 클라이언트가 받는 그대로 확인할 수 있습니다.

콘솔 요청도 일반 API 호출과 동일하게 분당 한도와 월 사용량을 차감합니다.

복사되는 cURL 명령은 실제 키 대신 $ECONALK_API_KEY를 사용하므로 그대로 공유해도 안전합니다.

日本語

このページから自分のキーで実際の API を呼び出せます。リクエストはブラウザーから、サーバーコードと同じエンドポイントへ直接送信されます。

  1. ECONALK API キーを貼り付けてください。キーはこのタブの外に出ず、ディスクにも保存されません。
  2. パラメーターを入力します。送信前に OpenAPI スキーマで値を検証します。
  3. 送信すると、ステータス、利用上限ヘッダー、JSON 本文をクライアントが受け取るままに確認できます。

コンソールからのリクエストも通常の API 呼び出しと同じく、毎分の上限と月間利用枠を消費します。

コピーされる cURL は生のキーではなく $ECONALK_API_KEY を参照するため、そのまま共有できます。

中文

可在本页使用自己的密钥调用真实 API。每次请求都从浏览器直接发送到与服务端代码相同的端点。

  1. 粘贴 ECONALK API 密钥。密钥不会离开当前浏览器标签页，也不会写入磁盘。
  2. 填写参数。发送前会依据 OpenAPI 架构校验取值。
  3. 发送后即可查看状态码、配额响应头和 JSON 正文，与客户端收到的内容完全一致。

控制台请求与普通 API 调用相同，会消耗每分钟速率限制和每月配额。

复制的 cURL 命令引用 $ECONALK_API_KEY 而非明文密钥，可安全分享。