v0.2.0-beta

OpenAPI 3.1.0

Lấy hoạt động ví Polymarket

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

Polymarket

Prediction-market discovery and market data.

Polymarket Thao tác

get/v1/beta/polymarket/activity

Lấy hoạt động ví Polymarket

Truy xuất hoạt động của thị trường dự đoán. Lọc thị trường bằng giá trị condition-ID, dùng start và end cho khoảng thời gian, limit và offset cho phân trang. Các bộ chọn bổ sung gồm eventId, type, side, sortBy và sortDirection. Phản hồi thành công là một mảng cấp cao nhất gồm các bản ghi hoạt động.

Tham chiếu giá

Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn

end
Kiểu: integer
tối thiểu:
0

Dấu thời gian giới hạn trên (giây epoch) cho cửa sổ hoạt động. Bỏ trống để dùng mặc định (thời điểm hiện tại); các hàng mới hơn end bị loại trừ.
eventId
Kiểu: array integer[]
tối thiểu:
1

Danh sách ID sự kiện được phân tách bằng dấu phẩy. Loại trừ lẫn nhau với market.
excludeDepositsWithdrawals
Kiểu: boolean

Loại trừ bản ghi nạp và rút tiền. Mặc định true vẫn áp dụng ngay cả khi type yêu cầu các bản ghi đó, vì vậy để lấy nạp và rút tiền bạn phải truyền false.
limit
Kiểu: integer
tối thiểu:
0
tối đa:
500

Kích thước trang. Các giá trị vượt quá mức tối đa sẽ bị giới hạn về 500.
market
Kiểu: array string[]

Danh sách ID điều kiện được phân tách bằng dấu phẩy. Loại trừ lẫn nhau với eventId.
offset
Kiểu: integer
tối thiểu:
0
tối đa:
5000

Chỉ số bắt đầu cho phân trang. Các yêu cầu vượt quá giới hạn bị từ chối với 400 (không bao giờ tự động giới hạn). Để đọc lịch sử sâu hơn offset 5000, hãy phân trang trong các cửa sổ start/end — mỗi cửa sổ có ngân sách offset riêng.
side
Kiểu: string enum
giá trị
- BUY
- SELL
sortBy
Kiểu: string enum
giá trị
- TIMESTAMP
- TOKENS
- CASH
sortDirection
Kiểu: string enum

DESC (mặc định) trả về các hàng mới nhất trước; ASC trả về cũ nhất trước. Cả hai thứ tự đều ổn định — cùng một truy vấn trả về cùng các hàng ở bất kỳ limit/offset nào, nên các trang ghép lại không có khoảng trống hay lặp lại.
giá trị
- ASC
- DESC
start
Kiểu: integer
tối thiểu:
0

Dấu thời gian giới hạn dưới (giây epoch) cho cửa sổ hoạt động. Bỏ trống hoặc truyền 0 để dùng cửa sổ mặc định (khoảng 3 năm gần nhất); truyền một epoch dương (ví dụ 1) để lấy toàn bộ lịch sử. Với sortDirection=ASC, bỏ qua start sẽ đọc ngay từ đầu lịch sử của tài khoản (không có cửa sổ mặc định).
type
Kiểu: array string[] enum

Danh sách các loại hoạt động cần bao gồm, phân tách bằng dấu phẩy. Bản ghi DEPOSIT và WITHDRAWAL cũng yêu cầu excludeDepositsWithdrawals=false.
giá trị
- TRADE
- SPLIT
- MERGE
- REDEEM
- REWARD
user
Kiểu: string
bắt buộc

Địa chỉ hồ sơ người dùng (tiền tố 0x, 40 ký tự hex)

Phản hồi

200
Kiểu: array object[] · Response65D835437A58_Activity[]

Thành công
asset
Kiểu: string

ID token mà hàng này tham chiếu. Được điền trên các hàng REDEEM với token mà hàng đó quyết toán. Để trống khi hàng không dành riêng cho token.

bio
Kiểu: string
conditionId
Kiểu: string · Response65D835437A58_Hash64

Chuỗi 64 ký tự hex có tiền tố 0x

eventSlug
Kiểu: string
icon
Kiểu: string

Hình ảnh thị trường. Quay về hình ảnh của thị trường, sau đó đến biểu tượng và hình ảnh của sự kiện gốc, khi thị trường không có biểu tượng riêng. Để trống trên các hàng CONVERSION.

isCombo
Kiểu: boolean

Đúng khi hàng này là một phần của vị thế tổ hợp (nhiều thị trường). Chỉ là cờ — chi tiết tổ hợp không được nhúng ở đây. conditionId của hàng bằng combo_condition_id của tổ hợp; truyền nó cho /v1/activity/combos hoặc /v1/positions/combos qua market_id để lấy các chân và chi tiết. Bị bỏ qua trên các hàng không phải tổ hợp.

name
Kiểu: string
outcome
Kiểu: string
outcomeIndex
Kiểu: integer

Chỉ số bắt đầu từ 0 của kết quả của hàng này trong mảng outcomes của thị trường, nên outcome luôn bằng outcomes[outcomeIndex]. Trên các hàng REDEEM, nó xác định kết quả mà hàng đó quyết toán, không phải kết quả thắng của thị trường. 999 nghĩa là không thể xác định kết quả, khi đó outcome để trống.

price
Kiểu: number
profileImage
Kiểu: string
profileImageOptimized
Kiểu: string
proxyWallet
Kiểu: string · Response65D835437A58_Address

Địa chỉ hồ sơ người dùng (tiền tố 0x, 40 ký tự hex)

pseudonym
Kiểu: string
side
Kiểu: string enum
giá trị
BUY
SELL
size
Kiểu: number

Số lượng token của hàng này. Trên các hàng REDEEM, đó là số token bị đốt cho kết quả của hàng này, nên việc đổi thưởng cả hai phía của một thị trường trả về một hàng cho mỗi kết quả thay vì một hàng kết hợp duy nhất.

slug
Kiểu: string
timestamp
Kiểu: integer Định dạng: int64

Signed 64-bit integers (long type).

title
Kiểu: string
transactionHash
Kiểu: string
type
Kiểu: string enum
giá trị
TRADE
SPLIT
MERGE
REDEEM
REWARD
usdcSize
Kiểu: number

Số USDC của hàng này. Trên các hàng REDEEM, đó là khoản thanh toán cho kết quả của hàng này và bằng 0 với kết quả thua; tổng các hàng của một lần đổi thưởng bằng tổng khoản thanh toán.
application/json
400

Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
401

Cần có khóa API Felo hợp lệ.
402

Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
403

Tài khoản không được phép thực hiện thao tác này.
429

Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
502

Dịch vụ không thể hoàn tất yêu cầu.
503

API hoặc dịch vụ thanh toán tạm thời không khả dụng.
504

Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
default

Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

application/json

get/v1/beta/polymarket/activity

curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Hiện schema

[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "timestamp": 1,
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "type": "TRADE",
    "size": 1,
    "usdcSize": 1,
    "transactionHash": "string",
    "price": 1,
    "asset": "string",
    "side": "BUY",
    "outcomeIndex": 1,
    "title": "string",
    "slug": "string",
    "icon": "string",
    "eventSlug": "string",
    "outcome": "string",
    "name": "string",
    "pseudonym": "string",
    "bio": "string",
    "profileImage": "string",
    "profileImageOptimized": "string",
    "isCombo": true
  }
]

Thành công

Lấy hoạt động ví Polymarket

Xác thựcRequired

Polymarket

Lấy hoạt động ví Polymarket

Tham chiếu giá