Cubesphere

Cubesphere Events API

무료 티어 이벤트 피드.

GitHub OpenAPI

Operations 1

GET /v1/events 이벤트 피드 — Form 4, 무료 티어(known_at 24시간 지연) #

Documentation

📖
Documentation
https://docs.cubesphere.xyz/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cubesphere-xyz/openapi/cubesphere-xyz-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/cubesphere-xyz/json-schema/cubesphere-xyz-events-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cubesphere-xyz:cubesphere-xyz-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cubesphere-xyz-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: public-api Events API
  description: 'SEC 공시(Form 4 · Form 144 · Schedule 13D/13G) API. 무인증(free) 또는 `X-API-Key`(basic/pro)로 쓴다. free 는 `known_at` 기준 24시간 지연된 데이터만 노출한다.


    ### 인증

    `X-API-Key` 헤더 없음 = free 티어(기본값). 유효한 키 = 24시간 게이트 우회 + tenant 가 소유한 basic/pro 한도. 키가 있는데 무효·폐기면 401(조용히 free 로 강등하지 않는다).


    ### 레이트리밋

    free: IP 당 분당 60 · 일당 2,000. basic: 키 당 분당 120 · 일당 10,000. pro: 키 당 분당 300 · 일당 50,000(IP 가 아니라 키 버킷). 초과하면 429 와 함께 `X-RateLimit-*` 헤더가 돌아온다(한도는 티어별로 다른 값을 반영).


    ### 라이선스

    가격(yfinance)에서 파생된 값은 티어와 무관하게 이 API 에 없다 — DB role 권한 자체가 그 테이블을 못 본다.'
  version: 0.1.0
tags:
- name: Events
  description: 무료 티어 이벤트 피드.
paths:
  /v1/events:
    get:
      tags:
      - Events
      summary: 이벤트 피드 — Form 4, 무료 티어(known_at 24시간 지연)
      operationId: list_events_v1_events_get
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 발행사 티커(대소문자 무관).
          title: Ticker
        description: 발행사 티커(대소문자 무관).
      - name: event_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: '`economic_event.event_type` 값.'
          title: Event Type
        description: '`economic_event.event_type` 값.'
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          description: recorded_at(=economic_event.created_at) 이 이 시각 이상인 것만.
          title: Since
        description: recorded_at(=economic_event.created_at) 이 이 시각 이상인 것만.
      - name: min_value
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          description: trade_value(=COALESCE(cash_purchase_value, cash_sale_value)) 최소값.
          title: Min Value
        description: trade_value(=COALESCE(cash_purchase_value, cash_sale_value)) 최소값.
      - name: quality_status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: CLEAN/INVARIANT_VIOLATION/SOURCE_INCOMPLETE/REVIEW_REQUIRED.
          title: Quality Status
        description: CLEAN/INVARIANT_VIOLATION/SOURCE_INCOMPLETE/REVIEW_REQUIRED.
      - name: cursor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 이전 응답의 next_cursor. 불투명 토큰.
          title: Cursor
        description: 이전 응답의 next_cursor. 불투명 토큰.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          description: 한 페이지 최대 행 수.
          default: 50
          title: Limit
        description: 한 페이지 최대 행 수.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventsResponse'
        '400':
          description: cursor 토큰이 깨졌다.
        '503':
          description: DB 에 붙지 못했다.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    EventsResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/EventItem'
          type: array
          title: Items
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Cursor
          description: 다음 페이지의 `cursor` 파라미터. null = 마지막 페이지.
        limitations:
          additionalProperties:
            type: string
          type: object
          title: Limitations
      additionalProperties: false
      type: object
      required:
      - items
      - limitations
      title: EventsResponse
    EventItem:
      properties:
        event_id:
          type: string
          title: Event Id
        event_revision:
          type: integer
          title: Event Revision
        event_type:
          type: string
          title: Event Type
        quality_status:
          type: string
          title: Quality Status
        rule_10b5_1_status:
          type: string
          title: Rule 10B5 1 Status
        transaction_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Transaction Date
        issuer_cik:
          anyOf:
          - type: string
          - type: 'null'
          title: Issuer Cik
        ticker:
          anyOf:
          - type: string
          - type: 'null'
          title: Ticker
          description: null = 대표 티커 미확정.
        issuer_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Issuer Name
        owner_cik:
          type: string
          title: Owner Cik
        owner_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Name
        gross_acquired_shares:
          anyOf:
          - type: number
          - type: 'null'
          title: Gross Acquired Shares
        gross_disposed_shares:
          anyOf:
          - type: number
          - type: 'null'
          title: Gross Disposed Shares
        net_share_change:
          anyOf:
          - type: number
          - type: 'null'
          title: Net Share Change
        cash_purchase_value:
          anyOf:
          - type: number
          - type: 'null'
          title: Cash Purchase Value
        cash_sale_value:
          anyOf:
          - type: number
          - type: 'null'
          title: Cash Sale Value
        trade_value:
          anyOf:
          - type: number
          - type: 'null'
          title: Trade Value
          description: COALESCE(cash_purchase_value, cash_sale_value) — `min_value` 필터가 비교하는 값.
        holding_change_pct:
          anyOf:
          - type: number
          - type: 'null'
          title: Holding Change Pct
        accession_no:
          type: string
          title: Accession No
          description: 이 이벤트의 앵커 공시.
        known_at:
          type: string
          format: date-time
          title: Known At
          description: 공시 접수 시각(UTC). 무료 티어 24시간 지연 게이트의 기준.
        recorded_at:
          type: string
          format: date-time
          title: Recorded At
          description: 우리 시스템이 이 이벤트를 기록한 시각. known_at 과 다를 수 있다(처리 지연).
      additionalProperties: false
      type: object
      required:
      - event_id
      - event_revision
      - event_type
      - quality_status
      - rule_10b5_1_status
      - owner_cik
      - accession_no
      - known_at
      - recorded_at
      title: EventItem
      description: '`GET /v1/events` 행 1건 — Form 4 해석 이벤트.


        **공통 계약**(#303): `event_revision`·`known_at`·`accession_no` 는 모든 행에 있다.

        가격에서 파생된 값은 여기 없다(라이선스 — README 참조).'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError