# Vextorium Uniswap Position Lookup

> Vextorium Uniswap Position Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Fetches detailed on-chain data for a Uniswap v3 liquidity position NFT, including pool, token pair, price range, liquidity, current tick, and pending fees.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/uniswap-position?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-uniswap-position-lookup-7bb562b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0D6qRZyWs4fKUzE92EfWZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-uniswap-position-lookup-7bb562b4 -d '<json body>'
```

Example prompt: Look up Uniswap v3 position NFT token ID 1500000 on the Base network and tell me if it's currently in range, what the price range is, and how much in pending fees I have.

## When to prefer this

Use this endpoint when you need granular, real-time details about a specific Uniswap v3 NFT position — especially tick data, in-range status, pending fees, and price ranges — across Base, Ethereum, Arbitrum, Optimism, or Polygon. Prefer this over generic DeFi aggregators when you know the exact NFT token ID and need structured, agent-consumable output via a pay-per-call model.

## Known failure modes

- Invalid or non-existent token_id returns an error or null fields
- Wrong network specified for the token_id results in empty or incorrect data
- Position is closed — returned with closed: true and zero liquidity
- Rate limit or payment failure via x402 protocol
- Network congestion causes delayed or stale on-chain data

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the pool contract address, owner wallet, token0 and token1 symbols and addresses, fee percentage, liquidity value, lower and upper ticks, current tick, price range (min, max, unit), whether the position is currently in range, whether it is closed, pending fees for each token, and the current price. A note about pending fee accounting is also included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string"
  },
  "token_id": {
   "type": "integer",
   "description": "Position NFT id"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Pending fees = those already accounted in the position; there may be more not updated until the next collect.",
  "pool": "0x547a9d0C948C08925f05B4224412f28d921Bca50",
  "owner": "0x0609374c4bd7646E50d1CB4760F48dc177fc3067",
  "closed": false,
  "token0": {
   "symbol": "NUTS",
   "address": "0x2f2f29f399B0a5b35642e71f1d4ea8C3D798DCB9"
  },
  "token1": {
   "symbol": "WETH",
   "address": "0x4200000000000000000000000000000000000006"
  },
  "fee_pct": 1,
  "network": "base",
  "in_range": false,
  "token_id": 1500000,
  "liquidity": "345586301430003022779041",
  "lower_tick": -219800,
  "upper_tick": -214200,
  "price_range": {
   "max": 4.987435543623297e-10,
   "min": 2.848948151993534e-10,
   "unit": "WETH por NUTS"
  },
  "current_tick": -242800,
  "pending_fees": {
   "NUTS": 0,
   "WETH": 0
  },
  "current_price": 2.856650949525111e-11
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-uniswap-position-lookup-7bb562b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)