거래 검색
1 크레딧/v1/us_congress_trades/trades하원과 상원 공시를 티커, 성, 정당, 원, 업종, 매수/매도/교환, 공개일로 걸러 반환합니다. 각 행에는 의원, 발행사, 티커, 공시 금액, 날짜, 보고 지연 일수가 있습니다. NVDA처럼 짧은 티커도 됩니다. 빈 목록은 환불됩니다.
ticker, politician, party, chamber, tx_type, start_date, end_date, cursor
US Congress Trades API미국 의회 주식 공시 데이터 API
SocialCrawl API 키로 하원과 상원의 STOCK Act 공시를 구조화 JSON으로 가져옵니다. 티커, 의원 성, 정당, 원, 날짜로 검색합니다. 호출은 크레딧으로 과금됩니다.
/v1/us_congress_trades
활성 엔드포인트 19개
- GET /v1/us_congress_trades/trades
- GET /v1/us_congress_trades/politician
- GET /v1/us_congress_trades/ticker
- GET /v1/us_congress_trades/members
- GET /v1/us_congress_trades/stats
SocialCrawl이 제공하는 미국 의회 공시 엔드포인트
하원과 상원 STOCK Act 공시를 읽는 엔드포인트 19개가 운영 중입니다. 전체를 검색하거나 의원·종목 단위로 조회한 뒤 정당, 업종, 이상 거래, 늦은 공시 통계를 받습니다. 아래는 주요 경로입니다. 나머지는 문서에 있습니다.
최근 공시
1 크레딧/v1/us_congress_trades/trades/latest최근 48시간 안에 공개된 STOCK Act 공시를 최신순으로 반환합니다. 행 형태는 검색 경로와 같습니다. 7일 구간은 trades/recent를 호출합니다.
cursor
의원 목록
1 크레딧/v1/us_congress_trades/members거래를 한 번이라도 공시한 의원의 이름, 성, 정당, 주를 반환합니다. 정당이나 주 약자로 거를 수 있습니다. 성은 handle로 politician에 넘깁니다.
party, state, cursor
의원 요약
1 크레딧/v1/us_congress_trades/politician성 하나의 집계를 반환합니다. 건수, 매수 대비 매도, 공시 금액, 평균 보고 지연, 주요 티커와 업종이 나옵니다. 없는 이름은 404이며 과금되지 않습니다.
handle
의원 공시 목록
1 크레딧/v1/us_congress_trades/politician/trades성 하나의 STOCK Act 행 전부를 반환합니다. 형태는 검색 경로와 같습니다. 공개일, 거래일, 금액, 보고 지연으로 정렬합니다.
handle, sort, order, cursor
종목 요약
1 크레딧/v1/us_congress_trades/ticker종목 하나의 의회 거래 집계를 반환합니다. 건수, 매수 대비 매도, 공시 금액, 의원 수, 그 종목을 가장 많이 거래한 의원이 나옵니다. AAPL과 AAPL:US를 모두 받습니다.
keyword
종목 공시 목록
1 크레딧/v1/us_congress_trades/ticker/trades종목 하나의 STOCK Act 행을 원, 정당, 거래 유형, 날짜로 걸러 반환합니다. 종목 요약에 쓴 keyword를 그대로 넘깁니다.
keyword, chamber, party, tx_type, start_date, end_date, cursor
주 단위 공시
1 크레딧/v1/us_congress_trades/state/trades한 주 출신 의원단의 공시를 반환합니다. 주 약자 두 글자(CA, TX, NY)를 넘깁니다. 없는 주는 404이며 과금되지 않습니다.
state, cursor
데이터셋 규모
1 크레딧/v1/us_congress_trades/stats총 거래 수, 의원 수, 가장 이른 거래일과 가장 늦은 거래일을 반환합니다. 검색 경로를 넘기기 전에 먼저 호출합니다.
none
이상 거래
1 크레딧/v1/us_congress_trades/stats/unusual최근 공시 건수가 과거 평균보다 뚜렷이 높은 티커와 관련 의원을 반환합니다. 그 티커는 keyword로 ticker/trades에 넘깁니다.
days, limit
US Congress Trades API19개 엔드포인트 지원
문서 보기Trades
Members
Tickers
Stats
하원과 상원의 STOCK Act 공시를 반환합니다. 티커, 의원, 정당, 원, 업종, 날짜로 걸러 볼 수 있습니다.
의회 거래를 검색할 때 사용하세요. 의원 한 명은 politician/trades, 종목 한 개는 ticker/trades에 넘기세요.
1크레딧
GET/v1/us_congress_trades/trades?ticker=NVDA&chamber=senate&tx_type=buy
$ curl https://www.socialcrawl.dev/v1/us_congress_trades/trades?ticker=NVDA&chamber=senate&tx_type=buy \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다SocialCrawl 미국 의회 공시 API의 동작 방식
미국 의회 공시는 일반적인 SocialCrawl 읽기 엔드포인트입니다. API 키로 GET /v1/us_congress_trades/… 을 호출하면 라이브 미스에만 크레딧이 차감되고 단일 JSON 응답이 반환됩니다. 식별 값은 성, 티커, 주 약자입니다.
모든 호출에 인증
x-api-key 헤더에 키를 담아 보냅니다. 같은 키가 SocialCrawl 카탈로그 전 구간에서 동작합니다.
쿼리 파라미터로 GET 요청
모든 경로는 GET입니다. 성은 handle, 티커는 keyword, 주는 state로 전달합니다. 잘못된 열거 값은 과금 전에 400을 반환합니다.
좌석이 아닌 크레딧 과금
미국 의회 공시 경로는 라이브 미스 기준 모두 1 크레딧입니다. 캐시 적중은 0 크레딧입니다. 빈 목록과 없는 의원, 티커, 주는 과금되지 않습니다.
단일 JSON 응답 구조
모든 응답은 success, data, credits_used, credits_remaining, request_id, cached로 동일한 형태입니다.
일반적인 연동 순서
대부분의 제품은 목록에서 성을 찾고 요약을 읽은 뒤 그 의원의 공시를 페이지 단위로 받습니다. 질문이 종목에서 시작하면 같은 순서를 티커에 적용합니다.
01목록
GET /v1/us_congress_trades/members거래를 한 번이라도 공시한 의원
handle로 넘길 성을 찾습니다.
02요약
GET /v1/us_congress_trades/politician?handle=…의원 한 명의 건수, 금액, 지연, 주요 티커와 업종
공시 전부를 넘기기 전에 그 의원을 확인합니다.
03공시
GET /v1/us_congress_trades/politician/trades?handle=…그 의원의 STOCK Act 행 SearchResult 페이지
커서가 사라질 때까지 페이지를 넘깁니다.
04종목
GET /v1/us_congress_trades/ticker?keyword=…종목 집계와 ticker/trades의 행
질문이 펠로시가 아니라 NVDA를 누가 거래했는가일 때 사용합니다.
요청
GET /v1/us_congress_trades/trades
?ticker=NVDA
&tx_type=buy
&limit=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/us_congress_trades/politician?handle=Pelosi응답 봉투
{
"success": true,
"data": {
"items": [
{
"politician": "Nancy Pelosi",
"ticker": "NVDA",
"tx_type": "buy",
"value": "$1,000,001 - $5,000,000"
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data에 담기는 내용
목록 경로는 SearchResult를 반환합니다. 요약은 Analytics를 반환합니다. 필드 이름은 그 아키타입 안에 있습니다.
SearchResulttrades
items[] 안의 의원, 발행사, 티커, 거래 유형, 금액, 날짜, 보고 지연
Analyticspolitician
의원 요약: 건수, 매수 대비 매도, 금액, 지연, 주요 티커와 업종
Analyticsticker
종목 요약: 건수, 매수 대비 매도, 금액, 의원 수, 주요 의원
Analyticsstats
데이터셋 규모: 총 거래 수, 의원 수, 가장 이른 거래일과 가장 늦은 거래일
게이트웨이 내부 동작
다른 /v1 플랫폼 엔드포인트와 요청 처리 흐름이 같습니다.
- 01
엣지에서 요청 수신
Next.js 캐치올 라우트가 Hono 소셜 API로 전달합니다. request_id를 발급하고 키를 인증한 뒤 요청 한도와 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 경로를 찾습니다. 성과 티커, 주, 열거 값을 먼저 검사하므로 잘못된 chamber는 과금 없이 400을 반환합니다.
- 03
캐시 확인 또는 원본 조회
플랫폼과 리소스, 파라미터로 결정적 캐시 키를 만듭니다. 적중하면 credits_used가 0입니다. 미스면 재시도와 서킷 브레이커를 거쳐 원본을 조회합니다.
- 04
정규화 후 반환
공시 행이나 집계를 SearchResult 또는 Analytics로 매핑하고 검증한 뒤 성공 응답으로 감싸고 과금 감사를 위해 기록합니다.
운영에서 중요한 과금 규칙
- 미국 의회 공시 경로 전부: 라이브 미스 기준 1 크레딧
- 캐시 적중: 0 크레딧
- 빈 목록: 200이며 환불됩니다
- 없는 의원, 티커, 주: 404이며 과금되지 않습니다
- 잘못된 handle이나 열거 값: 400이며 과금되지 않습니다
- 크레딧 부족: 402이며 과금되지 않습니다
- 중지된 경로: 503이며 과금되지 않습니다
- 검색과 종목 경로에서 AAPL처럼 짧은 티커를 받습니다
- 페이지는 cursor로 넘깁니다. 게이트웨이가 이 플랫폼에서는 offset으로 바꿉니다
SocialCrawl이 미국 의회 공시 데이터를 가져오는 방식
미국 의회 공시는 SocialCrawl에서 공개 STOCK Act 읽기 데이터입니다. 하원과 상원 공시를 공유 응답 형식으로 정규화하므로 정부 포털 두 곳을 따로 파싱할 필요가 없습니다.
이 API에서 다루는 범위
STOCK Act에 따라 하원과 상원 의원이 제출한 정기 거래 보고서입니다. 조사와 모니터링, 제품 작업을 위한 읽기 전용입니다.
SocialCrawl이 접근하는 방식
게이트웨이 뒤의 공개 읽기 업스트림을 통해 조회합니다. 하원 서기나 상원 전자공시 세션을 직접 유지할 필요가 없습니다.
엣지에서 나가는 형태
success, data, credits_used, request_id, cached로 구성된 통합 JSON 응답입니다. 목록은 SearchResult이고 요약은 Analytics입니다.
제공하지 않는 범위
실시간 시세와 옵션 체인, 쓰기 엔드포인트는 제공하지 않습니다. 시세 피드가 아니라 공시 데이터입니다. 상태 확인 경로는 고객 경로로 감싸지 않습니다.
필드 매핑
STOCK Act filing row→ SearchResult item공시 한 건: 의원, 발행사, 티커, 매수/매도/교환, 금액, 날짜, 지연
politician or ticker rollup→ Analytics의원 또는 종목 집계: 건수, 금액, 상대 상위 항목
dataset coverage totals→ Analytics코퍼스 합계와 날짜 범위
미국 의회 공시 API의 활용 분야
이 API가 가장 많이 쓰이는 작업입니다.
19active US Congress Trades endpoints in the registry
1모든 경로의 라이브 미스 1크레딧
의회 거래 모니터링과 STOCK Act 조사
호출은 필터된 거래 검색에 집중되며, 이어서 의원 한 명 또는 종목 하나를 자세히 조회합니다. 하원과 상원 STOCK Act 행을 같은 키로 받습니다. 성 조회와 티커 조회에 이상 거래와 늦은 공시 통계가 있으며 호출당 1 크레딧입니다.
조회는 라이브 미스 기준 보통 수 초가 걸립니다. 캐시 적중은 즉시 반환됩니다.
활용 사례
팀이 이 데이터를 실제로 활용하는 방식과 주로 쓰는 스택입니다.
대체 데이터 데스크
Python, 노트북, 웨어하우스 적재종목의 의회 거래 흐름을 보고, 이상 거래 급증을 자체 가격 시계열에 붙입니다.
정치 보도
Node, cron, Slack 봇trades/latest를 주기적으로 조회하고 특정 의원이 공시하거나 업종이 급증할 때 알립니다.
감시와 규제 조사
Go, 워커, Explorer늦은 공시자를 순위로 본 뒤 같은 handle로 그 의원의 공시를 페이지 단위로 받습니다.
미국 의회 공시 API 호출 방법
라이브 미스는 1 크레딧이 차감됩니다. 캐시 적중은 무료입니다. 빈 목록과 없는 식별 값은 과금되지 않습니다.
curl "https://www.socialcrawl.dev/v1/us_congress_trades/trades?ticker=NVDA&tx_type=buy&limit=20" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/us_congress_trades/politician?handle=Pelosi" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
US Congress Trades API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
TradesSearch US Congress stock tradesTrades LatestLatest US Congress trades (48 hours)Trades RecentRecent US Congress trades (7 days)MembersList members of Congress who have disclosed tradesPoliticianGet a politician's trading summaryPolitician TradesList trades for one politicianTickerGet congressional trading stats for a tickerTicker TradesList congressional trades for a tickerState TradesList trades from a state's congressional delegationStatsDataset summaryStats PartyCompare trade counts by partyStats SectorsTrade counts by industry sectorStats IssuersMost-traded issuers in CongressStats PoliticiansMost-active congressional tradersStats TickersMost-traded tickers in CongressStats VolumeCongressional trade volume over timeStats UnusualTickers with unusual congressional activityStats Buy SellCongressional buy vs sell ratioStats Reporting GapsPoliticians ranked by late STOCK Act filings
비교
SocialCrawl과 하원·상원 공시 포털, 뭐가 다른가요?
같은 US Congress Trades 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 하원·상원 공시 포털 |
|---|---|---|
| 한 호출로 다루는 범위 | 하원과 상원 STOCK Act 행을 검색 경로 하나로 | 포털 두 곳, 형식 두 가지, 의원별 문서 |
| 티커·성 조회 | ticker=NVDA 또는 handle=Pelosi 쿼리 | 의원 한 명씩 문서를 열어 봐야 함 |
| 응답 형태 | 카탈로그 전 구간과 같은 JSON 응답 | 원마다 HTML, XML, 스캔 PDF가 섞임 |
| 통계 | 정당, 업종, 이상 거래, 늦은 공시가 포함됨 | 파일을 받은 뒤 직접 집계해야 함 |
| 인증과 요금 | x-api-key 하나, 라이브 미스당 1 크레딧 | API 없음. 포털마다 수동 다운로드 |
한 호출로 다루는 범위
SocialCrawl
하원과 상원 STOCK Act 행을 검색 경로 하나로
하원·상원 공시 포털
포털 두 곳, 형식 두 가지, 의원별 문서
티커·성 조회
SocialCrawl
ticker=NVDA 또는 handle=Pelosi 쿼리
하원·상원 공시 포털
의원 한 명씩 문서를 열어 봐야 함
응답 형태
SocialCrawl
카탈로그 전 구간과 같은 JSON 응답
하원·상원 공시 포털
원마다 HTML, XML, 스캔 PDF가 섞임
통계
SocialCrawl
정당, 업종, 이상 거래, 늦은 공시가 포함됨
하원·상원 공시 포털
파일을 받은 뒤 직접 집계해야 함
인증과 요금
SocialCrawl
x-api-key 하나, 라이브 미스당 1 크레딧
하원·상원 공시 포털
API 없음. 포털마다 수동 다운로드
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기의회 주식 공시는 API로 어떻게 받나요?
x-api-key를 넣고 GET /v1/us_congress_trades/trades를 호출하면 돼요. 티커, 의원 성, 정당, 원, 업종, 매수/매도/교환, 공개일로 걸러 볼 수 있고, 다른 플랫폼과 같은 JSON 응답으로 와요.
미국 의회 공시 API는 무엇을 반환하나요?
하원과 상원의 STOCK Act 정기 거래 보고서를 반환해요. 각 행에는 의원, 발행사, 티커, 거래 유형, 공시 금액, 거래일과 공개일, 보고 지연 일수가 담겨 있어요.
의원 한 명의 공시만 볼 수 있나요?
네. 성을 handle로 /v1/us_congress_trades/politician에 넘기면 요약이 오고, 같은 handle로 politician/trades를 치면 공시 목록이 와요. 예: handle=Pelosi.
미국 의회 공시 API 요금은 얼마인가요?
모든 경로가 라이브 미스 기준 1 크레딧이에요. 캐시 적중, 빈 목록, 없는 의원·티커·주는 과금되지 않고, 새 계정에는 100 크레딧이 있어요.
실시간 주가도 나오나요?
아니요. 시세 피드가 아니라 공시 데이터예요. 누가 무엇을 언제 보고했는지를 받을 때 쓰고, 가격은 Finance 시세 경로를 쓰면 돼요.
티커나 원으로 어떻게 거르나요?
/v1/us_congress_trades/trades에 ticker=NVDA와 chamber=senate 또는 chamber=house를 넣으면 돼요. NVDA처럼 짧은 티커도 되고, 잘못된 열거 값은 과금 전에 400이 나요.
US Congress Trades 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 US Congress Trades 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. US Congress Trades 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
US Congress Trades 스크래핑 API와 공식 US Congress Trades API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 US Congress Trades 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요