NavScope API

Access real-time cryptocurrency prices, token metadata, safety scores, and category data programmatically. All endpoints return JSON. No authentication required for the free tier.

Base URL

https://api.navscope.io

All responses are application/json. Timestamps are ISO 8601 UTC. Prices are in USD unless otherwise noted.

Rate Limits

Tier	Rate Limit	Daily Cap	API Key Required
Free (unauthenticated)	100 requests / minute	10,000 requests / day	No
Registered	1,000 requests / minute	500,000 requests / day	Yes
Commercial	Custom	Custom	Yes

When you exceed a rate limit the API returns HTTP 429 Too Many Requests. A Retry-After header indicates the number of seconds to wait. For commercial licensing contact [email protected].

Endpoints

GET/api/prices/latest

Returns the latest aggregated price snapshot for all tracked tokens. Each record includes the AI safety score and sparkline data for 7-day mini-charts.

Parameters

Name	Type	Required	Description
limit	integer	no	Maximum number of tokens to return (default: 50, max: 1000)

Request

GET https://api.navscope.io/api/prices/latest?limit=5

Response

{
  "count": 5,
  "updatedAt": "2026-03-15T10:30:00Z",
  "tokens": [
    {
      "groupId": "btc-bitcoin",
      "symbol": "BTC",
      "price": 84250.42,
      "change24h": 2.31,
      "change7d": -1.18,
      "aiScore": 91,
      "sparkline": [82100, 82800, 83500, 84000, 84250],
      "rank": 1
    },
    {
      "groupId": "eth-ethereum",
      "symbol": "ETH",
      "price": 3284.17,
      "change24h": 1.45,
      "change7d": 3.72,
      "aiScore": 88,
      "sparkline": [3140, 3200, 3250, 3270, 3284],
      "rank": 2
    }
  ]
}

GET/api/metadata/all

Returns full metadata for all tracked tokens including market cap, 24-hour volume, circulating supply, and AI safety scores.

Request

GET https://api.navscope.io/api/metadata/all

Response

{
  "count": 523,
  "tokens": [
    {
      "groupId": "btc-bitcoin",
      "symbol": "BTC",
      "name": "Bitcoin",
      "logoUrl": "https://assets.navscope.io/logos/btc.png",
      "price": 84250.42,
      "marketCap": 1652000000000,
      "volume24h": 28500000000,
      "circulatingSupply": 19620000,
      "maxSupply": 21000000,
      "change24h": 2.31,
      "change7d": -1.18,
      "aiScore": 91,
      "rank": 1
    }
  ]
}

GET/api/metadata/{symbol}

Returns full metadata and per-exchange price breakdown for a single token identified by its symbol (case-insensitive).

Parameters

Name	Type	Required	Description
symbol	string	yes	Token symbol, e.g. BTC, ETH, SOL (case-insensitive)

Request

GET https://api.navscope.io/api/metadata/ETH

Response

{
  "groupId": "eth-ethereum",
  "symbol": "ETH",
  "name": "Ethereum",
  "logoUrl": "https://assets.navscope.io/logos/eth.png",
  "price": 3284.17,
  "marketCap": 394700000000,
  "volume24h": 14200000000,
  "circulatingSupply": 120200000,
  "change24h": 1.45,
  "change7d": 3.72,
  "aiScore": 88,
  "aiScoreBreakdown": {
    "liquidityScore": 90,
    "volatilityScore": 82,
    "anomalyScore": 95,
    "exchangeCoverageScore": 100
  },
  "exchanges": [
    { "name": "Binance",  "price": 3284.10, "volume24h": 5800000000, "spread": 0.003 },
    { "name": "Coinbase", "price": 3284.25, "volume24h": 3100000000, "spread": 0.004 },
    { "name": "Kraken",   "price": 3283.95, "volume24h": 1900000000, "spread": 0.005 }
  ],
  "rank": 2
}

GET/api/categories

Returns a list of all token categories tracked by NavScope, including token count and aggregate market cap per category.

Request

GET https://api.navscope.io/api/categories

Response

{
  "count": 24,
  "categories": [
    {
      "slug": "layer-1",
      "name": "Layer 1",
      "description": "Base-layer blockchains with native consensus",
      "tokenCount": 38,
      "marketCap": 2140000000000,
      "change24h": 1.82
    },
    {
      "slug": "defi",
      "name": "DeFi",
      "description": "Decentralised finance protocols and governance tokens",
      "tokenCount": 91,
      "marketCap": 87000000000,
      "change24h": -0.54
    }
  ]
}

GET/api/categories/{slug}

Returns all tokens belonging to a specific category, sorted by market cap descending.

Parameters

Name	Type	Required	Description
slug	string	yes	Category slug as returned by GET /api/categories (e.g. layer-1, defi)

Request

GET https://api.navscope.io/api/categories/layer-1

Response

{
  "slug": "layer-1",
  "name": "Layer 1",
  "tokenCount": 38,
  "tokens": [
    {
      "groupId": "btc-bitcoin",
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 84250.42,
      "marketCap": 1652000000000,
      "change24h": 2.31,
      "aiScore": 91,
      "rank": 1
    },
    {
      "groupId": "eth-ethereum",
      "symbol": "ETH",
      "name": "Ethereum",
      "price": 3284.17,
      "marketCap": 394700000000,
      "change24h": 1.45,
      "aiScore": 88,
      "rank": 2
    }
  ]
}

Error Codes

HTTP Status	Meaning
200 OK	Request successful
400 Bad Request	Missing or invalid parameter
404 Not Found	Symbol or category slug not found
429 Too Many Requests	Rate limit exceeded — check Retry-After header
500 Internal Server Error	Unexpected server error — please retry

Coming Soon

API key authentication and developer dashboard
WebSocket streaming for live price updates
Webhook subscriptions for price alerts and threshold notifications
Historical OHLCV data endpoints
Portfolio valuation endpoint