home / skills / openclaw / skills / priceforagent

priceforagent skill

Q: How do I get an API key?

Register your agent by POSTing to /v1/register with an agent_id; the response includes an api_key.

safe

This skill provides real-time prices for crypto, stocks, and commodities via natural language queries and direct lookups.

npx playbooks add skill openclaw/skills --skill priceforagent

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.9 KB

---
name: priceforagent
description: Get real-time prices for crypto, stocks, and commodities. Use when the user asks about asset prices, market data, or needs to check the value of Bitcoin, Ethereum, stocks like NVDA/AAPL, or commodities like gold/silver. Supports natural language queries ("What's the price of Bitcoin?") and direct lookups.
---

# 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
}
```

Overview

This skill provides real-time prices for cryptocurrencies, stocks, and commodities via a simple API. It supports both natural-language queries and direct lookups, returning price, bid/ask, market status, currency, and timestamps. Use it to check single assets, query multiple symbols in batch, or integrate live pricing into agents and dashboards.

How this skill works

The service exposes endpoints for registration, natural-language queries, direct price lookups, and batch requests. After registering an agent to get an API key, calls to /v1/query accept plain English questions while /v1/price/{asset} and /v1/batch accept direct symbol lookups. Responses include price, bid, ask, currency, market state, and a timestamp. Rate limits and an OpenAPI spec are provided for integration.

When to use it

When a user asks the current price of Bitcoin, Ethereum, or other crypto
To fetch stock quotes for symbols like NVDA, AAPL, TSLA, or GOOGL
To check commodity values such as gold, silver, or oil
When you need batch pricing for multiple assets in a single request
When integrating live price data into a bot, dashboard, or trading tool

Best practices

Register an agent to obtain and securely store an API key before calling endpoints
Prefer batch endpoints for multiple symbols to reduce rate-limit pressure
Use the natural-language query endpoint for conversational interfaces and the direct endpoints for deterministic lookups
Cache responses short-term if ultra-low latency is needed and exact real-time precision is not required
Monitor /v1/usage and respect the 2 requests/sec per-key rate limit to avoid throttling

Example use cases

Chatbot answering "What’s the price of Bitcoin and Ethereum right now?" using the natural-language endpoint
Background job fetching NVDA and AAPL prices every minute via the batch endpoint for a portfolio dashboard
Mobile app displaying gold and silver spot prices using direct lookup endpoints
Automated alert that triggers when BTC bid/ask spreads widen beyond a threshold

FAQ

How do I get an API key?

What rate limits apply?

Each API key is limited to 2 requests per second; there is also a large global cap and usage tracking via /v1/usage.