python-proxy-scraper-client/README.md

A TypeScript client for interacting with a Python proxy scraper service

# Python Proxy Scraper Client

A TypeScript client for interacting with a Python proxy scraper service. This client provides a convenient interface to interact with blockchain data and trading information.

## Features

- TypeScript support with full type definitions
- Blockchain service integration
- Environment variable configuration
- Easy to use client interface
- Support for multiple chains (ETH, BSC, SOL, TRX)

## Installation

```bash
npm install python-proxy-scraper-client
```

## Usage

```typescript
import { Client } from 'python-proxy-scraper-client';

// Initialize the client
const client = new Client();

// Get trending tokens
const trendingTokens = await client.blockchain.gmgn.getTrendingTokens('eth', '1h');

// Get token security information
const tokenSecurity = await client.blockchain.gmgn.getTokenSecurityAndLaunchpad(
    '0x123...', // token address
    'eth'       // chain
);

// Get wallet holdings
const holdings = await client.blockchain.gmgn.getWalletHoldings(
    '0x456...', // wallet address
    'eth'       // chain
);
```

## Configuration

The client can be configured using environment variables:

1. Create a `.env` file in your project root:
```env
BACKEND_URL=http://your-backend-url
```

2. Or pass the URL directly when initializing the client:
```typescript
const client = new Client('http://your-backend-url');
```

## Available Chains

- `eth` - Ethereum
- `bsc` - Binance Smart Chain
- `sol` - Solana
- `trx` - TRON

## Development

```bash
# Install dependencies
npm install

# Build the project
npm run build

# Run the example
npm start
```

## License

ISC