Pinax API

Quick reference for AI agents using Pinax API. The authoritative machine-readable contract is GET /openapi.

• Base URL: https://api.pinax.network
• OpenAPI spec: GET /openapi — authoritative reference, use for schema details
• x402 discovery: GET /.well-known/x402 — payment discovery metadata; x402 enforcement is handled at the proxy layer
• Docs: https://app.pinax.network/docs
• FAQ: https://app.pinax.network/help
• Canonical skill file: GET /SKILL.md

All responses are JSON: { "data": [...], ... } for data endpoints, or a top-level object for monitoring. Errors follow { "status": <code>, "code": "<slug>", "message": "<text>" }.

Authentication

Most endpoints require a Bearer token from The Graph Market:

Authorization: Bearer <your-token>

An X-Api-Key: <your-api-key> header is accepted as an alternative.

Unauthenticated endpoints (no header required, no usage charge):

• GET /llms.txt
• GET /openapi
• GET /.well-known/x402
• GET /SKILL.md
• GET /v1/health
• GET /v1/version
• GET /v1/networks
• GET /v1/evm/dexes
• GET /v1/svm/dexes
• GET /v1/polymarket/markets
• GET /v1/hyperliquid/dexes
• GET /v1/hyperliquid/markets

Errors

Error responses share a common envelope:

{
  "status": 400,
  "code": "bad_query_input",
  "message": "Invalid network ID"
}

Common codes: bad_query_input (400), authentication_failed (401), route_not_found (404), bad_database_response (500), database_connection_failed (503).

Capabilities

Map a goal to the relevant dataset and endpoint family:

• Token API: look up wallet balances and transfer history — /v1/{evm,svm}/balances, /v1/{evm,svm}/transfers
• Token API: track balance changes over time — /v1/evm/balances/historical, /v1/evm/balances/historical/native
• Token API: resolve token metadata — /v1/{evm,svm}/tokens, /v1/{evm,svm}/tokens/native
• Token API: find holders of a token — /v1/{evm,svm}/holders, /v1/evm/holders/native, /v1/evm/nft/holders
• Token API: trace DEX swaps and liquidity pools — /v1/{evm,svm}/swaps, /v1/{evm,svm}/pools, /v1/{evm,svm}/dexes
• Token API: get OHLC time-series — /v1/{evm,svm}/pools/ohlc
• Token API: list a wallet's NFT holdings and activity — /v1/evm/nft/ownerships, /v1/evm/nft/transfers, /v1/evm/nft/sales, /v1/evm/nft/items, /v1/evm/nft/collections
• Prediction Markets: discover markets, OI, and per-user PNL — /v1/polymarket/markets, /v1/polymarket/markets/ohlc, /v1/polymarket/markets/oi, /v1/polymarket/markets/activity, /v1/polymarket/users, /v1/polymarket/users/positions, /v1/hyperliquid/outcomes, /v1/hyperliquid/outcomes/ohlc, /v1/hyperliquid/outcomes/trades, /v1/hyperliquid/outcomes/users, /v1/hyperliquid/outcomes/users/positions, /v1/hyperliquid/outcomes/users/activity
• Perp Exchanges: discover markets, OHLC, OI, liquidations, and per-user PnL — /v1/hyperliquid/markets, /v1/hyperliquid/markets/ohlc, /v1/hyperliquid/markets/oi, /v1/hyperliquid/markets/liquidations, /v1/hyperliquid/users, /v1/hyperliquid/users/positions, /v1/hyperliquid/vaults
• Discover supported chains and protocols (free) — /v1/networks, /v1/{evm,svm}/dexes, /v1/hyperliquid/dexes

Common patterns

These conventions apply across the data endpoints unless overridden.

Pagination

Parameter	Type	Default	Description
limit	integer	10	Items per page. Maximum is plan-restricted (free tier capped lower).
page	integer	1	Page number. An empty data array signals end of results.

Batched filters

Any parameter marked "supports multiple" accepts either a repeated query param (?contract=0x..&contract=0x..) or a comma-separated list (?contract=0x..,0x..). This applies to most ID-shaped filters (address, contract, mint, token_id, pool, transaction_id, signature, etc.).

Time ranges

Event and historical endpoints accept either block or time windows:

• start_time / end_time — ISO 8601 or Unix timestamp (seconds)
• start_block / end_block — integer block number (slot for SVM)

Intervals

Historical and OHLC endpoints use an interval enum: 1h, 4h, 1d (default), 1w. A few endpoints accept additional values (e.g. /v1/polymarket/users supports 30d); the OpenAPI per-endpoint schema is authoritative.

Network discovery

Call GET /v1/networks first to enumerate supported network IDs (mainnet, base, bsc, solana, …) and see how current each indexer is via indexed_to.

Worked example

Fetch WETH balances for a wallet on Ethereum:

1. GET /v1/networks                              → confirm "mainnet" is indexed
2. GET /v1/evm/tokens?network=mainnet
        &contract=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
                                                 → resolve WETH metadata
3. GET /v1/evm/balances?network=mainnet
        &address=0x<wallet>
        &contract=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
                                                 → current balance
4. GET /v1/evm/balances/historical?network=mainnet
        &address=0x<wallet>
        &contract=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
        &interval=1d&start_time=2026-01-01       → time-series

---

Monitoring

Endpoint	Required	Optional	Notes
GET /v1/health	—	—	200 when all DBs are up, 503 otherwise
GET /v1/version	—	—	Version, build date, commit
GET /v1/networks	—	network	Supported chains + indexed_to per category; network filter is batched

---

EVM endpoints

Ethereum and compatible chains (Ethereum, Base, BSC, Polygon, Arbitrum, …).

Tokens (ERC-20)

Endpoint	Required	Optional
GET /v1/evm/tokens	network, contract	—
GET /v1/evm/tokens/native	network	—

Balances

Endpoint	Required	Optional
GET /v1/evm/balances	network, address	contract, include_null_balances
GET /v1/evm/balances/native	network, address	—
GET /v1/evm/balances/historical	network, address	contract, interval, start_time, end_time
GET /v1/evm/balances/historical/native	network, address	interval, start_time, end_time

Transfers

Endpoint	Required	Optional
GET /v1/evm/transfers	network	transaction_id, contract, from_address, to_address, start_time, end_time, start_block, end_block
GET /v1/evm/transfers/native	network	transaction_id, from_address, to_address, start_time, end_time, start_block, end_block

Holders

Endpoint	Required	Optional
GET /v1/evm/holders	network, contract	—
GET /v1/evm/holders/native	network	—

DEX / swaps / pools

Endpoint	Required	Optional
GET /v1/evm/swaps	network	transaction_id, transaction_from, factory, pool, caller, user, sender, recipient, input_contract, output_contract, protocol, start_time, end_time, start_block, end_block
GET /v1/evm/dexes	network	—
GET /v1/evm/pools	network	factory, pool, input_token, output_token, protocol
GET /v1/evm/pools/ohlc	network, pool	interval, start_time, end_time

Swap response includes several address fields:

• transaction_from — onchain transaction initiator
• caller — account or contract that invokes the swap
• user — normalized user-oriented swap address; prefer this for new integrations
• sender, recipient — legacy fields, slated for deprecation in a future major release

NFTs

Endpoint	Required	Optional
GET /v1/evm/nft/collections	network, contract	—
GET /v1/evm/nft/items	network, contract	token_id
GET /v1/evm/nft/holders	network, contract	—
GET /v1/evm/nft/ownerships	network, address	contract, token_id, token_standard (ERC721 | ERC1155), include_null_balances
GET /v1/evm/nft/transfers	network	type (BURN | MINT | TRANSFER), transaction_id, contract, token_id, address, from_address, to_address, start_time, end_time, start_block, end_block
GET /v1/evm/nft/sales	network	transaction_id, contract, token_id, address, from_address, to_address, start_time, end_time, start_block, end_block

---

SVM endpoints

Solana Virtual Machine chains.

Tokens (SPL)

Endpoint	Required	Optional
GET /v1/svm/tokens	network, mint	—
GET /v1/svm/tokens/native	network	—

Balances

Endpoint	Required	Optional
GET /v1/svm/balances	network, owner	token_account, mint, program_id, include_null_balances
GET /v1/svm/balances/native	network, address	include_null_balances

Transfers

Endpoint	Required	Optional
GET /v1/svm/transfers	network	signature, source, destination, authority, mint, program_id, start_time, end_time, start_block, end_block
GET /v1/svm/transfers/native	network	signature, source, destination, start_time, end_time, start_block, end_block

Holders

Endpoint	Required	Optional
GET /v1/svm/holders	network, mint	—
GET /v1/svm/holders/native	network	—

In /v1/svm/holders, the owner field is the wallet and token_account is the Associated Token Account (ATA).

DEX / swaps / pools

Endpoint	Required	Optional
GET /v1/svm/swaps	network	signature, amm, amm_pool, user, input_mint, output_mint, program_id, start_time, end_time, start_block, end_block
GET /v1/svm/dexes	network	—
GET /v1/svm/pools	network	amm, amm_pool, input_mint, output_mint, program_id
GET /v1/svm/pools/ohlc	network, amm_pool	interval, start_time, end_time

Account owner

Endpoint	Required	Optional
GET /v1/svm/owner	network, account	—

---

Polymarket

Prediction-market data for the Polygon-based Polymarket CTF exchange. Outcome token prices are quoted in USDC per share (0–1).

Markets

Endpoint	Required	Optional	Notes
GET /v1/polymarket/markets	—	condition_id, market_slug, token_id, event_slug, closed, sort_by (volume | end_date | start_date)	Unauthenticated. Discover token_id / condition_id here before calling other endpoints.
GET /v1/polymarket/markets/ohlc	token_id	interval, start_time, end_time	OHLC for a single outcome token
GET /v1/polymarket/markets/oi	—	condition_id or market_slug (mutually exclusive), interval, start_time, end_time	Open-interest time-series
GET /v1/polymarket/markets/activity	one of user, token_id, condition_id	event_type (trade | split | merge | redeem), start_time, end_time	Defaults to last 24h when no time range is given
GET /v1/polymarket/markets/positions	token_id	closed, sort_by (position_value | realized_pnl | unrealized_pnl | total_pnl | pnl_pct | transactions | avg_price)	Leaderboard of users holding this outcome

Users

Endpoint	Required	Optional	Notes
GET /v1/polymarket/users	—	user, interval (1h | 1d | 1w | 30d), sort_by (total_volume | realized_pnl | unrealized_pnl | total_pnl | transactions)	Per-user volume and PNL; omit interval for all-time
GET /v1/polymarket/users/positions	user	token_id, condition_id, market_slug, closed, sort_by (position_value | realized_pnl | unrealized_pnl | total_pnl | pnl_pct | transactions | avg_price | current_price)	A single user's positions with PNL breakdown

Platform

Endpoint	Required	Optional
GET /v1/polymarket/platform	—	interval, start_time, end_time

Aggregate volume, open interest, and fees across all Polymarket markets.

---

Hyperliquid

Trading data for the Hyperliquid L1 — core perps, @N-indexed spot pairs, builder-deployed DEXes (xyz, cash, …), and HIP-4 prediction-market outcomes. The coin parameter is the canonical identifier across all /v1/hyperliquid/markets/* and /v1/hyperliquid/users/* endpoints: unprefixed for core perps (BTC), @N for spot (@107), and <dex>:<symbol> for builder DEXes (xyz:SILVER). Discover the live DEX set via GET /v1/hyperliquid/dexes.

HIP-4 outcome markets are served by the dedicated /v1/hyperliquid/outcomes/* family — #N coin values and dex=outcome are rejected on the markets/users endpoints. Outcome coins use #<outcome_id*10 + side_index> encoding (side_index is 0 or 1, e.g. #1720 = outcome 172 / "Yes", #1721 = outcome 172 / "No").

Markets

Endpoint	Required	Optional	Notes
GET /v1/hyperliquid/dexes	—	—	Unauthenticated. All supported DEX ids.
GET /v1/hyperliquid/markets	—	coin, dex, base_token, quote_token	Unauthenticated. Latest snapshot per market: last price, 24h change, taker buy/sell volume, OI, funding rate. open_interest, funding_rate, and funding_snapshot_time are null on spot markets. base_token / quote_token are spot-discovery filters.
GET /v1/hyperliquid/markets/ohlc	coin	dex, interval, start_time, end_time	OHLCV per coin (and optional dex). Volume fields (buy_volume, sell_volume, gross_volume, net_volume) carry the crossed-taker directional split; transactions is the true match count.
GET /v1/hyperliquid/markets/oi	coin	dex, interval, start_time, end_time	Open-interest time-series. Default interval=1h.
GET /v1/hyperliquid/markets/activity	—	coin, dex, user, direction (batched, 18-tag enum incl. BUY/SELL, perp OPEN_*/CLOSE_*, liquidations, SETTLEMENT), start_time, end_time	Trade-fill stream.
GET /v1/hyperliquid/markets/liquidations	—	coin, dex, liquidated_user, direction (batched, 7-tag liquidation enum), sort_by (notional | time), start_time, end_time	Per-fill liquidation feed.
GET /v1/hyperliquid/markets/liquidations/ohlc	coin	dex, interval, start_time, end_time	OHLCV of liquidation notional. Same taker-derived volume semantics as /markets/ohlc.

Users

Endpoint	Required	Optional	Notes
GET /v1/hyperliquid/users	—	user, coin, dex, interval (1h | 1d | 1w | 30d), sort_by (total_volume | transactions | total_fees | realized_pnl | total_funding | liquidation_fills)	Dual mode: profile when user is set, leaderboard otherwise. Omit interval for all-time. Refreshed hourly.
GET /v1/hyperliquid/users/positions	user	coin, dex	Open perp positions per user.
GET /v1/hyperliquid/users/activity	user	event_types (batched: bridge_deposit, bridge_withdraw_pending, bridge_withdraw_finalized, deposit, withdraw, vault_deposit, vault_withdraw, liquidation, funding), start_time, end_time	Balance-changing events. Defaults to last 30 days. For trade fills, use /v1/hyperliquid/markets/activity.

Vaults

Endpoint	Required	Optional	Notes
GET /v1/hyperliquid/vaults	—	vault, sort_by (lifetime_deposits | lifetime_withdrawals | lifetime_distributions | depositor_count | last_activity_at)	Lifetime flow stats. Vaults predating the indexer cutover have null leader / created_at.
GET /v1/hyperliquid/vaults/depositors	vault	sort_by (deposits | withdrawals | distributions_received | last_activity_at)	Per-depositor stake in a vault.

Outcomes (HIP-4 prediction markets)

Endpoint	Required	Optional	Notes
GET /v1/hyperliquid/outcomes	—	outcome_id, question_id, status (live | settled | all, default live), quote_token, include_fallback, sort_by (volume_24h | last_trade | outcome_id)	Outcome listing with 24h trading rollup. Each row carries sides[] (the two side coins), question (or null for binary single-outcome markets), price_yes, volume_24h, trades_24h, last_trade. include_fallback=true exposes each multi-outcome question's catch-all leg (off by default).
GET /v1/hyperliquid/outcomes/ohlc	coin (#N)	interval, start_time, end_time	Per-leg OHLCV. Same taker-derived volume semantics as /markets/ohlc minus the perp-only open_long_volume/close_long_volume fields.
GET /v1/hyperliquid/outcomes/trades	One of: coin, outcome_id, question_id, user	The other identifiers, direction (batched, 7-tag enum: BUY, SELL, SETTLEMENT, SPLIT_OUTCOME, MERGE_OUTCOME, MERGE_QUESTION, NEGATE_OUTCOME), start_time, end_time	Fill stream over outcome_fills joined to outcome metadata. Defaults to last 24h.
GET /v1/hyperliquid/outcomes/users	One of: user, outcome_id, question_id	interval (1h | 1d | 1w | 30d), sort_by (total_volume | transactions | realized_pnl)	Per-outcome trading aggregates with Yes+No side legs collapsed into one row per (user, outcome). Profile mode when user is set; leaderboard mode (sorted by sort_by) when omitted. Refreshed hourly.
GET /v1/hyperliquid/outcomes/users/positions	One of: user, coin, outcome_id, question_id	—	Current open share balances per (user, outcome leg). Holder list (sorted by share_balance desc) when user is omitted. Reconciles against HL spotClearinghouseState for live users.
GET /v1/hyperliquid/outcomes/users/activity	One of: user, coin, outcome_id, question_id	direction (batched, composition-only 5-tag enum: SETTLEMENT, SPLIT_OUTCOME, MERGE_OUTCOME, MERGE_QUESTION, NEGATE_OUTCOME), start_time, end_time	Composition-event feed (resolution payouts + HIP-4 collateral reshapes), one row per (event, affected leg). Defaults to last 24h. BUY/SELL are rejected here — for taker fills, use /v1/hyperliquid/outcomes/trades.

Platform

Endpoint	Required	Optional
GET /v1/hyperliquid/platform	—	interval, start_time, end_time

Cross-coin, cross-DEX time-series of volume (taker-derived buy_volume / sell_volume), fees, trade counts (true match count), and a liquidation slice.