cryptofeed
id:bmoscon/cryptofeed ·
· 目录记录
项目概述
Cryptofeed是多交易所行情feed处理库,订阅成交、订单簿、报价等事件后,把各所格式统一为对象交给异步callback,或写到数据库/消息后端。它解决跨所实时数据接入差异,不是策略或默认实盘交易器。
原项目介绍
忠实中文 / 作者自述整理
作者称库处理多个crypto exchange feeds,尽量用WebSocket,无WS则可轮询REST,并标准化回传事件。
短摘 / 原文
Cryptocurrency Exchange Feed Handler
出处:https://github.com/bmoscon/cryptofeed/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
Cryptofeed是多交易所行情feed处理库,订阅成交、订单簿、报价等事件后,把各所格式统一为对象交给异步callback,或写到数据库/消息后端。它解决跨所实时数据接入差异,不是策略或默认实盘交易器。
谁会用
构建行情管道、订单簿分析、交易研究数据服务的Python工程师。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
多交易所行情字段、频道与时间戳格式不同,难直接统一消费。
文档化使用场景(编辑归纳)
订阅后用标准对象与receipt_timestamp回调或写入后端,明确缺失/延迟边界。
主要能力与用途
FeedHandler按交易所/币对/频道添加订阅;callback拿到规范化对象和收到消息的时间。
频道含L1/L2/L3 book、taker侧成交、funding、open interest、liquidations和K线,但各所不一定全提供。
支持从指定交易所feed合成最佳bid/ask(NBBO),不等于覆盖全市场或可直接无风险套利。
字段用统一symbol与Decimal;区分交易所事件时间和接收时间,缺事件时间时后端可用接收时间。
后端可写Redis、Kafka、Postgres、ClickHouse等,需相应服务和权限;快照/增量/序号/checksum仅在交易所提供时有值。
如何使用 / 既有稿流程
选所/币对/频道→注册异步callback或存储backend→启动feed→按标准对象处理事件/增量。这里只阅读流程,不安装Python依赖、订阅外网、记录订单簿或写第三方数据库。
用法证据状态
documented_workflow_only_not_executed
公开限制
不同所深度范围不一,部分L2/L3只有子集;标准对象不保证原数据完整/无延迟。
默认只发已收K线、初始历史批次默认可关闭等行为需按场景核对,不能默认回调就是全历史。
README标Python3.13+;API限流、断线、数据授权/费用和事件时间缺失仍需处理,未执行测试。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
NOASSERTION
discussion_zh
README徽章AGPL,具体版本与LICENSE全文未读;数据库和行情提供者条款分别核对。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
多交易所行情字段、频道与时间戳格式不同,难直接统一消费。
documented_use_case_zh
订阅后用标准对象与receipt_timestamp回调或写入后端,明确缺失/延迟边界。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:46:13.122530+08:00
来源
https://github.com/bmoscon/cryptofeed/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/bmoscon/cryptofeed/README.md.phase032-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:46:07.224220+08:00", "sha256": "c70739b172b1d158c4a78d57d36844c5003c98b4e00abae533ac8bf41817edb7", "read_scope": "README前约1–150行:订阅/标准化/频道/后端及capture标题;不读重放细节或实现,不接行情", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/bmoscon/cryptofeed
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:15+08:00", "description": "Cryptocurrency Exchange Websocket Data Feed Handler", "topics": [ "asyncio", "binance", "binance-api", "bitcoin", "btc", "coinbase", "coinbase-api", "crypto", "cryptocurrencies", "cryptocurrency", "ethereum", "exchange", "influxdb", "market-data", "python", "trading", "trading-platform", "websocket", "websockets" ], "record_sha256": "03b72c6a2955b96936c4f99e383c64e433ee8b4459af8bab47ea9c68609eb793", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "README前约1–150行:订阅/标准化/频道/后端及capture标题;不读重放细节或实现,不接行情",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "91bdb7adb4b9605fab50b80b6da0495fc9b9c09f1381c7964feb2122e3773de6"
}