pinax-api

Query Pinax API endpoints for token, prediction market, and perp exchange blockchain data.

21|5|Updated May 29, 2024
One-click install
npx skills add https://github.com/pinax-network/pinax-api --skill pinax-api-pinax-network
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pinax-api
Source: https://github.com/pinax-network/pinax-api/tree/main/skills
Command: npx skills add https://github.com/pinax-network/pinax-api --skill pinax-api-pinax-network

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Integrating with the Pinax API requires knowing which endpoints exist, which parameters they require, and how authentication, pagination, and error handling work across EVM, SVM, and TVM networks. This Skill gives an AI agent the complete endpoint reference and usage conventions needed to build correct API requests without trial and error. ## Core Features & Use Cases - Token API Coverage: Query balances, transfers, holders, token metadata, DEX swaps, pools, OHLC data, and NFT ownership across EVM, SVM, and TVM networks. - Prediction Markets & Perps: Access Polymarket market data, user positions, and PnL, plus Hyperliquid markets, liquidations, vaults, and HIP-4 outcome markets. - Request Conventions: Built-in guidance on Bearer token authentication, pagination, batched filters, time ranges, and interval enums. - Use Case: Ask the agent to fetch a wallet's historical WETH balance on Ethereum, and it will confirm the network via /v1/networks, resolve the token contract, then call the balances and historical balances endpoints with the right parameters. ## Quick Start Ask the agent to fetch the current token balances for a wallet address on Ethereum mainnet using the Pinax API.

Frequently Asked Questions about pinax-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query wallet token balances with the Pinax API?

Call GET /v1/evm/balances with the network and address parameters, optionally filtering by contract. For Solana use /v1/svm/balances with owner, and include a Bearer token from The Graph Market in the Authorization header.

How do I get historical token balance data for a wallet?

Use GET /v1/evm/balances/historical with network, address, and optional contract, interval, start_time, and end_time parameters. Intervals support 1h, 4h, 1d, and 1w, and time ranges accept ISO 8601 or Unix timestamps.

Which blockchain networks does the Pinax API support?

The API supports EVM chains like Ethereum, Base, BSC, Polygon, and Arbitrum, plus Solana (SVM) and Tron (TVM). Call the unauthenticated GET /v1/networks endpoint to list current network IDs and indexing status.

Does the Pinax API require authentication for all endpoints?

Most endpoints require a Bearer token from The Graph Market or an X-Api-Key header. Discovery endpoints like /v1/networks, /v1/health, /openapi, and Polymarket and Hyperliquid market listing endpoints are unauthenticated.

How does pagination work in Pinax API responses?

Data endpoints accept limit and page query parameters, with limit defaulting to 10 and capped by plan tier. An empty data array in the response signals that you have reached the end of the results.

What data is available for Hyperliquid and Polymarket?

Hyperliquid endpoints cover perp and spot markets, OHLC, open interest, liquidations, user positions, vaults, and HIP-4 outcome markets. Polymarket endpoints cover market discovery, OHLC, open interest, activity, and per-user positions and PnL.