priceforagent

# Price for Agent

LLM-friendly price service for crypto, stocks, and commodities.

**Base URL:** `https://p4ai.bitharga.com`

## Quick Start

### 1. Register for API Key

```bash
curl -X POST https://p4ai.bitharga.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent"}'
```

Response:
```json
{"api_key": "pfa_xxx...", "message": "API key generated successfully"}
```

### 2. Query Prices

**Natural language:**
```bash
curl -X POST https://p4ai.bitharga.com/v1/query \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is the price of Bitcoin and Ethereum?"}'
```

**Direct lookup:**
```bash
curl -H "X-API-Key: YOUR_KEY" https://p4ai.bitharga.com/v1/price/bitcoin
```

**Batch:**
```bash
curl -X POST https://p4ai.bitharga.com/v1/batch \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pairs": ["BTC", "ETH", "NVDA"]}'
```

## Supported Assets

| Type | Examples |
|------|----------|
| Crypto | BTC, ETH, SOL, DOGE, XRP, BNB |
| Stocks | NVDA, AAPL, TSLA, GOOGL |
| Commodities | GOLD, SILVER, OIL |

## Rate Limits

- 2 requests per second per API key
- Global limit: 10 million calls
- Usage tracked via `/v1/usage`

## Function Calling

```bash
curl https://p4ai.bitharga.com/v1/function-schema
```

## OpenAPI Spec

```bash
curl https://p4ai.bitharga.com/v1/openapi.yaml
```

## Response Format

```json
{
  "pair": "BTC",
  "price": 70494.63,
  "ask": 70565.13,
  "bid": 70424.14,
  "currency": "USDT",
  "market": "open",
  "timestamp": 1770433814
}
```