1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//! Polymarket Data API client and types.
//!
//! **Feature flag:** `data` (required to use this module)
//!
//! This module provides a client for interacting with the Polymarket Data API,
//! which offers HTTP endpoints for querying user positions, trades, activity,
//! market holders, open interest, volume data, and leaderboards.
//!
//! # Overview
//!
//! The Data API is a read-only HTTP API that provides access to Polymarket data.
//! It is separate from the CLOB (Central Limit Order Book) API which handles trading.
//!
//! ## Available Endpoints
//!
//! | Endpoint | Description |
//! |----------|-------------|
//! | `/` | Health check |
//! | `/positions` | Get current positions for a user |
//! | `/trades` | Get trades for a user or markets |
//! | `/activity` | Get on-chain activity for a user |
//! | `/holders` | Get top holders for markets |
//! | `/value` | Get total value of a user's positions |
//! | `/closed-positions` | Get closed positions for a user |
//! | `/traded` | Get total markets a user has traded |
//! | `/oi` | Get open interest for markets |
//! | `/live-volume` | Get live volume for an event |
//! | `/v1/leaderboard` | Get trader leaderboard rankings |
//! | `/v1/builders/leaderboard` | Get builder leaderboard rankings |
//! | `/v1/builders/volume` | Get daily builder volume time-series |
//!
//! # Example
//!
//! ```no_run
//! use polymarket_client_sdk::types::address;
//! use polymarket_client_sdk::data::{Client, types::request::PositionsRequest};
//!
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! // Create a client with the default endpoint
//! let client = Client::default();
//!
//! // Build a request for user positions
//! let request = PositionsRequest::builder()
//! .user(address!("56687bf447db6ffa42ffe2204a05edaa20f55839"))
//! .build();
//!
//! // Fetch positions
//! let positions = client.positions(&request).await?;
//!
//! for position in positions {
//! println!("{}: {} tokens at ${:.2}",
//! position.title,
//! position.size,
//! position.current_value
//! );
//! }
//! # Ok(())
//! # }
//! ```
//!
//! # API Base URL
//!
//! The default API endpoint is `https://data-api.polymarket.com`.
pub use Client;