npm package: @gliss-sh/sdk-typescript
Description: Official TypeScript SDK for the Gliss API - providing access to Polymarket data including markets, orders, orderbooks, activity, and wallet analytics.
Latest version: 0.4.0

# Gliss TypeScript SDK

Official TypeScript SDK for the Gliss API - providing access to Polymarket data including markets, orders, orderbooks, activity, and wallet analytics.

## Installation

```bash
npm install @gliss-sh/sdk-typescript
# or
bun add @gliss-sh/sdk-typescript
# or
pnpm add @gliss-sh/sdk-typescript
```

## Quick Start

```typescript
import { createGlissClient, getV0PolymarketMarkets } from '@gliss-sh/sdk-typescript'

// Create an authenticated client
const client = createGlissClient('your-api-key')

// Fetch markets
const { data, error } = await getV0PolymarketMarkets({
  client,
  query: {
    status: 'open',
    limit: 10
  }
})

if (error) {
  console.error('Error:', error)
} else {
  console.log('Markets:', data.markets)
}
```

## Authentication

Get your API key from [gliss.sh](https://gliss.sh) and create a client:

```typescript
import { createGlissClient } from '@gliss-sh/sdk-typescript'

const client = createGlissClient(process.env.GLISS_API_KEY!)
```

## Available Endpoints

### Markets
```typescript
import { getV0PolymarketMarkets } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketMarkets({
  client,
  query: {
    market_slug: 'bitcoin-up-or-down',
    status: 'open',
    limit: 20
  }
})
```

### Orders
```typescript
import { getV0PolymarketOrders } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketOrders({
  client,
  query: {
    market_slug: 'bitcoin-up-or-down',
    start_time: 1699999999,
    limit: 100
  }
})
```

### Orderbooks
```typescript
import { getV0PolymarketOrderbooks } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketOrderbooks({
  client,
  query: {
    token_id: '123...',
    start_time: 1699999999,
    end_time: 1700000000
  }
})
```

### Activity
```typescript
import { getV0PolymarketActivity } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketActivity({
  client,
  query: {
    wallet_address: '0x123...',
    start_time: 1699999999
  }
})
```

### Market Price
```typescript
import { getV0PolymarketMarketPriceByTokenId } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketMarketPriceByTokenId({
  client,
  path: {
    token_id: '123...'
  },
  query: {
    at_time: 1699999999 // Optional: get historical price
  }
})
```

### Wallet P&L
```typescript
import { getV0PolymarketWalletPnlByWalletAddress } from '@gliss-sh/sdk-typescript'

const { data } = await getV0PolymarketWalletPnlByWalletAddress({
  client,
  path: {
    wallet_address: '0x123...'
  },
  query: {
    start_time: 1699999999,
    end_time: 1700000000,
    granularity: 'day'
  }
})
```

## Advanced Usage

### Custom Client Configuration

```typescript
import { createClient, createConfig } from '@gliss-sh/sdk-typescript'

const client = createClient(createConfig({
  baseUrl: 'https://api.gliss.sh',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'X-Custom-Header': 'value'
  },
  // Add custom fetch options
  fetch: customFetchImplementation
}))
```

### TypeScript Types

All request and response types are fully typed:

```typescript
import type {
  GetV0PolymarketMarketsData,
  GetV0PolymarketMarketsResponses,
  Market,
  MarketStatus
} from '@gliss-sh/sdk-typescript'
```

## Error Handling

```typescript
const { data, error, response } = await getV0PolymarketMarkets({ client })

if (error) {
  console.error('Status:', response.status)
  console.error('Error:', error)
  // Handle error
} else {
  // Handle success
  console.log('Markets:', data.markets)
}
```

## Documentation

- [API Documentation](https://api.gliss.sh/docs)
- [GitHub Repository](https://github.com/yourusername/gliss)
- [Website](https://gliss.sh)

## License

MIT

## Support

For issues and questions:
- GitHub Issues: https://github.com/yourusername/gliss/issues
- Email: support@gliss.sh