DCE API Rust Client

A high-performance, asynchronous Rust client library for the Dalian Commodity Exchange (DCE) API.

Ported from the dceapi-go library, this SDK provides a type-safe and efficient way to interact with DCE market data, news, delivery, and trading services.

Features

Asynchronous: Built on tokio and reqwest for modern async/await workflows.
Auto-Token Management: Handles API token acquisition and automatic refresh before expiry.
Retry Mechanism: Automatically retries requests on token expiration (HTTP 402).
Compression Support: Supports Gzip, Brotli, and Deflate for faster data transfer.
Type Safety: Comprehensive Rust models for all request and response structures.
Error Handling: Detailed error types using thiserror.

Services

News: Get articles, announcements, and notices.
Common: Retrieve current trade dates and variety (commodity) lists.
Market: Fetch day, night, week, and month quotes, plus contract statistics.
Trade: Get trading parameters and contract information.
Settle: Retrieve settlement parameters.
Member: Access member trading and volume rankings.
Delivery: Get delivery data, warehouse receipts, costs, and premiums.

Installation

Add this to your Cargo.toml:

[dependencies]
dceapi = { path = "./path/to/dceapi-rs" } # Adjust the path accordingly
tokio = { version = "1", features = ["full"] }

Quick Start

Set Environment Variables

export DCE_API_KEY="your-api-key"
export DCE_SECRET="your-secret"

Basic Usage

use dceapi::{Client, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create client from environment variables
    let client = Client::from_env()?;

    // Get current trade date
    let trade_date = client.common.get_curr_trade_date(None).await?;
    println!("Current trade date: {}", trade_date.date);

    // Get variety list
    let varieties = client.common.get_variety_list(None).await?;
    for v in varieties.iter().take(5) {
        println!("Variety: {} ({})", v.name, v.code);
    }

    Ok(())
}

Examples

The project includes two examples:

Basic: Simple demonstration of trade date and variety list retrieval.
```
cargo run --example basic
```
Complete: Comprehensive usage of all available services.
```
cargo run --example complete
```

Configuration

You can also configure the client manually:

use dceapi::{Client, Config};
use std::time::Duration;

let config = Config::new()
    .with_api_key("your-api-key")
    .with_secret("your-secret")
    .with_timeout(Duration::from_secs(30))
    .with_lang("zh");

let client = Client::new(config)?;

License

MIT / Apache-2.0

dceapi-rs 0.1.0