> ## Documentation Index
> Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# US Congress Trades — Latest

> Returns public STOCK Act disclosures published in the last 48 hours, newest first, from Capitol Trades. Exact UTC publication timestamps determine inclusion. Trade values are source estimates, not exact amounts. Supports limit 1–100 (default 50), offset up to 1,000,000, and one-hour cursors bound to the same feed, limit and time window. Empty results have no net credit charge.

Returns public STOCK Act disclosures **published in the last 48 hours**, newest first. Inclusion uses the exact source publication timestamp in UTC, not the date the trade occurred or a timezone-shifted display label.

Each item has its source disclosure ID and URL, issuer ID/name/ticker/sector, the member's professional identity (name, party, state and chamber), publication and trade dates, transaction type, owner category and reporting delay. `value_estimate_usd` is the source's estimate of a reported amount range; it is **not an exact transaction amount**. `price_usd` may be null. Unrelated birth dates and gender are excluded.

Use `limit` from 1–100 (default 50), or a nonnegative `offset` up to 1,000,000. Prefer `next_cursor`: it preserves the window and limit for one hour and checks the preceding disclosure ID. A source edit or new disclosure that changes page order may require restarting. At most two native 100-row pages are fetched per request. A final cursor page can be empty when the inclusive source calendar-day window extends before the exact cutoff.

`window_start` and `window_end` are exact UTC bounds. `source_candidate_total` counts the source's inclusive calendar-date candidates, which can include records before the exact cutoff; `total` is null because this request does not scan the entire window. This feed reflects the source's public coverage, not a complete official filing archive. Broader trade search and aggregate statistics are separate operations and are not implied by these feeds.

Each successful fresh nonempty request costs **1 SocialQuery credit**. Validated empty results, failures, cache hits and successful idempotent replays have no net charge. The adapter uses one or two basic Firecrawl requests within the configured allowance and validates source URLs, query dates, native page counts, disclosure links, ordering and IDs before returning data.


## OpenAPI

````yaml GET /us_congress_trades/trades/latest
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /us_congress_trades/trades/latest:
    get:
      tags:
        - Us Congress Trades
      summary: Us Congress Trades Trades Latest
      description: >-
        Returns public STOCK Act disclosures published in the last 48 hours,
        newest first, from Capitol Trades. Exact UTC publication timestamps
        determine inclusion. Trade values are source estimates, not exact
        amounts. Supports limit 1–100 (default 50), offset up to 1,000,000, and
        one-hour cursors bound to the same feed, limit and time window. Empty
        results have no net credit charge.
      operationId: get_us_congress_trades_trades_latest
      parameters:
        - name: limit
          in: query
          required: false
          example: 20
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            maximum: 1000000
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use next_cursor verbatim within one hour; keep the same feed and
            limit. The cursor fixes the publication window and checks the
            preceding disclosure. Source edits can require restarting.
        - name: Cache-Control
          in: header
          required: false
          example: no-cache
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c
          schema:
            type: string
        - name: X-Max-Credits
          in: header
          required: false
          description: >-
            Optional nonnegative integer cap on the maximum request hold. A live
            request whose hold exceeds this cap returns 422
            CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the
            requested limit; cache hits and successful idempotent replays cost
            zero.
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: >-
            Returns public STOCK Act disclosures published in the last 48 hours,
            newest first, from Capitol Trades. Exact UTC publication timestamps
            determine inclusion. Trade values are source estimates, not exact
            amounts. Supports limit 1–100 (default 50), offset up to 1,000,000,
            and one-hour cursors bound to the same feed, limit and time window.
            Empty results have no net credit charge.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SocialQueryResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          items:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                url:
                                  type: string
                                issuer:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    name:
                                      type: string
                                    ticker:
                                      type:
                                        - string
                                        - 'null'
                                    sector:
                                      type:
                                        - string
                                        - 'null'
                                  required:
                                    - id
                                    - name
                                    - ticker
                                    - sector
                                politician:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    first_name:
                                      type: string
                                    last_name:
                                      type: string
                                    display_name:
                                      type: string
                                    party:
                                      type: string
                                    state:
                                      type: string
                                    chamber:
                                      type: string
                                  required:
                                    - id
                                    - first_name
                                    - last_name
                                    - display_name
                                    - party
                                    - state
                                    - chamber
                                pub_date:
                                  type: string
                                tx_date:
                                  type: string
                                tx_type:
                                  type: string
                                owner:
                                  type:
                                    - string
                                    - 'null'
                                reporting_gap_days:
                                  type: integer
                                  minimum: 0
                                value_estimate_usd:
                                  type: integer
                                  minimum: 0
                                price_usd:
                                  type:
                                    - number
                                    - 'null'
                              required:
                                - id
                                - url
                                - issuer
                                - politician
                                - pub_date
                                - tx_date
                                - tx_type
                                - owner
                                - reporting_gap_days
                                - value_estimate_usd
                                - price_usd
                          returned_count:
                            type: integer
                            minimum: 0
                          total:
                            type: 'null'
                          limit:
                            type: integer
                            minimum: 0
                          offset:
                            type: integer
                            minimum: 0
                          next_cursor:
                            type:
                              - string
                              - 'null'
                          window_start:
                            type: string
                          window_end:
                            type: string
                          source_candidate_total:
                            type: integer
                            minimum: 0
                          source:
                            type: string
                          coverage_note:
                            type: string
                        required:
                          - items
                          - returned_count
                          - total
                          - limit
                          - offset
                          - next_cursor
                          - window_start
                          - window_end
                          - source_candidate_total
                          - source
                          - coverage_note
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '402':
          $ref: '#/components/responses/Error402'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '405':
          $ref: '#/components/responses/Error405'
        '409':
          $ref: '#/components/responses/Error409'
        '422':
          $ref: '#/components/responses/Error422'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '502':
          $ref: '#/components/responses/Error502'
        '503':
          $ref: '#/components/responses/Error503'
        '504':
          $ref: '#/components/responses/Error504'
components:
  schemas:
    SocialQueryResponse:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - data
      properties:
        success:
          type: boolean
          const: true
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        data:
          type: object
          additionalProperties: true
          description: >-
            The selected operation determines the resource fields in this
            object. Source data can omit a metric or report it as null.
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  responses:
    Error400:
      description: Upstream rejected the request.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error401:
      description: Missing, expired, invalid, or revoked API key.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error402:
      description: Insufficient SocialQuery credits.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error403:
      description: Key scope or provider policy denied access.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error404:
      description: Endpoint or upstream resource not found.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error405:
      description: HTTP method is not supported.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error409:
      description: Idempotency conflict or request in progress.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error422:
      description: Invalid parameters.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error429:
      description: Request limit reached.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error500:
      description: Request processing failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error502:
      description: Upstream service failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error503:
      description: Provider or required service is unavailable.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error504:
      description: Upstream service timed out.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.