AC

apro-com/ai-oracle-skills

Developer tools
24 stars Quality 44 Trend 32

agents can use these skills to query ai-oracle apis and generate the api calling codes.

Overview

✅ Your AI Agent (swaps, liquidations, lending) and needs ✅ You need to to detect manipulation ✅ You're building a that requires mark prices verifiable by smart contracts ✅ You need that can be validated on-chain via ecrecover Query real-time crypto prices with and . Covers 9 sectors, 1400+ tokens. : CoinGecko · CoinMarketCap · DexAve · DexDexTools Generate in TypeScript, Python, Go, Rust, React, or Solidity. Output is automatically compiled and verified before delivery. : TypeScript · Python · Go · Rust · React/Next.js · Solidity Pre-built OpenAI-compatible function calling schemas for use with (OpenAI SDK, LangChain, CrewAI, AutoGen). : - tools.json — 6 tool definitions (OpenAI function calling format) - system_prompt.txt — System prompt with API conventions - handler.py — Python tool executor (zero dependencies) Public test keys provided by APRO. No registration required.

README

APRO AI Oracle Skills

Multi-source crypto price verification with on-chain signature proofs + production-ready Oracle client code generation.


🎯 What Makes APRO Different

vs. CoinMarketCap / CoinGecko / Other Data APIs

Feature APRO Oracle CMC/CoinGecko
On-chain signatures ✅ 5 ECDSA signers ❌ None
Multi-source aggregation ✅ 4 sources (median) ❌ Single source
Smart contract verifiable ✅ ecrecover ❌ Not verifiable
Designed for AI Agents ✅ Native skill format ⚠️ Generic API
Code generation ✅ Skill-driven ❌ Manual

When you need APRO instead of CMC/CoinGecko:

✅ Your AI Agent executes on-chain operations (swaps, liquidations, lending) and needs verifiable price proofs
✅ You need to compare prices across 4 data sources to detect manipulation
✅ You’re building a Perp DEX / DeFi protocol that requires mark prices verifiable by smart contracts
✅ You need cryptographically signed price data that can be validated on-chain via ecrecover


📦 What’s Included

🔍 Skill 1: Ticker Query — Real-time Price Verification

Query real-time crypto prices with 4-source aggregation and 5 on-chain ECDSA signatures. Covers 9 sectors, 1400+ tokens.

Use cases:

💬 "What's the current BTC price? Show all data source quotes"
💬 "Top 5 AI sector coins by 24h gain"
💬 "Show me ETH daily OHLCV for the past week"
💬 "Get BTC price with signature data and signer addresses"

Data sources: CoinGecko · CoinMarketCap · DexAve · DexDexTools

📖 Full documentation →


🛠️ Skill 2: Oracle Integration — Code Generator

Generate production-ready Oracle client libraries in TypeScript, Python, Go, Rust, React, or Solidity. Output is automatically compiled and verified before delivery.

Use cases:

💬 "Generate a Python APRO Oracle client"
💬 "Create a TypeScript SDK for APRO"
💬 "I'm building a DeFi Agent with ElizaOS, integrate APRO Oracle"
💬 "Generate Solidity contract interface to verify APRO signatures"

Supported languages: TypeScript · Python · Go · Rust · React/Next.js · Solidity

📖 Full documentation →


⚙️ Bonus: OpenAI Function Calling Integration

Pre-built OpenAI-compatible function calling schemas for use with any LLM framework (OpenAI SDK, LangChain, CrewAI, AutoGen).

What’s included:

  • tools.json — 6 tool definitions (OpenAI function calling format)
  • system_prompt.txt — System prompt with API conventions
  • handler.py — Python tool executor (zero dependencies)

📖 Setup guide →


⚡ Quick Start

Test Credentials

APRO_API_KEY=31a3870def37415d853ec96eb1ae6274
APRO_API_SECRET=Lz6gu/6r0dOLsFOrx/VkU7LudaPb55AFqeCsbjQhQ4rr756neFG1NlKEmANMH6a2

Public test keys provided by APRO. No registration required.

For Claude Code Users

  1. Open Claude Code
  2. Select Browse and install plugins
  3. Search for APRO-com/ai-oracle-skills
  4. Install both skills
  5. Ask: “What’s the current BTC price?” or “Generate a Python APRO client”

For Other AI Agents

# Install via npx skills (Vercel)
npx skills add APRO-com/ai-oracle-skills

# Or clone and use directly
git clone https://github.com/APRO-com/ai-oracle-skills.git

🧪 Testing

Run the API test script against all 6 endpoints:

# Set credentials (or use defaults in script)
export APRO_API_KEY="your-key"
export APRO_API_SECRET="your-secret"

# Run all endpoint tests
./test_ticker_api.sh

Expected output: 8 passed, 0 failed


🎯 Success Stories

DeFi Agent Price Manipulation Detection

Scenario: A DeFi Agent needed to verify prices before executing swaps.

Solution: Compared 4 APRO data sources, rejected swaps if price variance > 2%.

Result: Blocked 3 price manipulation attempts (DEX single-source anomaly, but APRO median was normal).


Perp DEX Mark Price with On-Chain Verification

Scenario: A perpetual contract DEX needed verifiable mark prices for liquidation.

Solution: Called APRO /price every minute, wrote 5 signatures to smart contract, verified on-chain via ecrecover.

Result: Fully on-chain verifiable price feeds without trusting centralized oracles.


48-Hour Integration from Zero to Production

Scenario: A Perp DEX team needed to integrate APRO in 48 hours.

Solution: Used Skill 2 to generate Go client, integrated into backend.

Result:

  • Code generation: 15 minutes
  • Integration testing: 4 hours
  • Production deployment: Day 2
  • Estimated time saved: 2-3 days

📊 API Overview

Endpoint Description
GET /v2/ticker/currencies/list List all supported cryptocurrencies (1400+)
GET /v2/ticker/currency/support Check if a currency is supported
GET /v2/ticker/currency/price Get current price with 5 on-chain signatures
GET /v2/ticker/currency/category/list List all categories (9 sectors)
GET /v2/ticker/currency/category/coins Get coins in a category
GET /v2/ticker/currency/ohlcv OHLCV candlestick data (hourly/daily)

Base URL: https://api-ai-oracle.apro.com

Authentication: Requires X-API-KEY and X-API-SECRET headers.

Important: The API uses full cryptocurrency names (e.g., name=Bitcoin), NOT ticker symbols. See the OpenAPI spec for full details.


🔧 Prerequisites

For ticker-query-skill (Skill 1)

Tool Purpose Install
Claude Code Skill runtime npm install -g @anthropic-ai/claude-code
curl API calls Pre-installed on macOS/Linux. Windows: winget install cURL.cURL
python3 JSON parsing Pre-installed on macOS/Linux. Windows: winget install Python.Python.3

For ai-oracle-integration (Skill 2)

Install the toolchain for your target language:

Language Tool Check Install
TypeScript Node.js + npm node -v && npm -v nodejs.org
Python Python 3 python3 --version python.org
Go Go 1.21+ go version go.dev/dl
Rust Cargo (rustup) cargo --version rustup.rs

Both skills will check for required tools before running and prompt you to install any that are missing.


🌐 About APRO Oracle

APRO is the industry’s first AI-focused Oracle, providing verifiable data for cutting-edge ecosystems.


📜 License

MIT — Free for commercial and non-commercial use.


🏷️ Topics

Add to your GitHub repository:

price-verification · multi-source-validation · on-chain-signature · sdk-generation · defi-oracle · crypto-market-data · ai-agent-skills · oracle-integration · perp-dex · signature-verification

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add apro-com/ai-oracle-skills