Build · Reference

API v1 reference.

Every endpoint is read-only, unauthenticated, JSON over HTTPS, and returns the same envelope. The PRISM interface is built entirely on these routes.

Response envelope

Successful responses carry data and meta. Big integers (block numbers, raw token amounts) are strings. meta.window is the block range an aggregate was computed over; values outside it are not represented. Unknown values are null, never zero.

200 · application/json

{
  "data": { ... },
  "meta": {
    "requestId": "b6f1…",
    "observedAt": "2026-10-23T14:02:11.000Z",
    "source": "rpc",
    "blockNumber": "1840211",
    "window": { "fromBlock": "1838212", "toBlock": "1840211" },
    "methodology": "…"
  },
  "pagination": { "page": 1, "pageSize": 25, "total": 112 }
}

Errors

4xx / 5xx · application/json

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid query parameters",
    "details": [{ "path": ["pageSize"], "message": "Number must be less than or equal to 100" }]
  },
  "meta": { "requestId": "b6f1…", "observedAt": "2026-10-23T14:02:11.000Z" }
}

Error codes
Code	Status	Meaning
invalid_request	400	A path or query parameter failed validation. details lists each issue.
not_found	404	The block, transaction, address or pool does not exist on chain.
rate_limited	429	Too many requests in the current window. Honor Retry-After.
chain_unconfigured	503	No RPC endpoint is configured on this deployment.
upstream_error	502	The RPC endpoint failed or timed out. Safe to retry with backoff.
internal_error	500	Unexpected failure. Include the requestId when reporting.

Rate limits

180 requests per IP per 60-second fixed window. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (unix seconds). A 429 includes Retry-After. With Upstash Redis configured the window is shared across instances; otherwise it is per instance.

Endpoints

GET/api/v1/network/status

Network status

Connection state, latest block, block age, average block time, gas price, RPC latency and indexer configuration.

Edge cache 5s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/network/status"

GET/api/v1/network/blocks

Latest blocks

The most recent blocks, newest first.

Parameters for Latest blocks
Name	In	Type	Description
limit	query	integer 1–40	Number of blocks. Default 20.

Edge cache 5s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/network/blocks"

GET/api/v1/network/blocks/{number}

Block by number

A single block with its transaction hashes.

Parameters for Block by number
Name	In	Type	Description
number*	path	integer ≥ 0	Block number.

Edge cache 5s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/network/blocks/1840211"

GET/api/v1/transactions/{hash}

Transaction

Transaction, receipt status, gas, and decoded ERC-20 transfers it emitted.

Parameters for Transaction
Name	In	Type	Description
hash*	path	0x 32-byte hash	Transaction hash.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/transactions/0x…"

GET/api/v1/addresses/{address}

Address

Native balance, nonce, contract flag, token metadata if the address is a token, and recent transfers touching it.

Parameters for Address
Name	In	Type	Description
address*	path	0x address	Account or contract address.

Edge cache 15s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/addresses/0x…"

GET/api/v1/search

Search

Resolves a block number, transaction hash, address or token symbol to typed results.

Parameters for Search
Name	In	Type	Description
q*	query	string 1–80	Query.

Edge cache 15s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/search"

GET/api/v1/assets

Assets

Tokenized assets from the configured registry plus tokens discovered in the indexed window, each with a verification label.

Parameters for Assets
Name	In	Type	Description
page	query	integer ≥ 1	Page number. Default 1.
pageSize	query	integer 1–100	Items per page. Default 25.
category	query	equity \| etf \| stablecoin \| commodity \| other	Filter by category.
verification	query	registry \| discovered	Filter by source.
q	query	string	Symbol or name contains.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/assets"

GET/api/v1/assets/{address}

Asset

Token metadata, total supply, transfer activity series, top holders by flow, and pools containing the token.

Parameters for Asset
Name	In	Type	Description
address*	path	0x address	Token contract address.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/assets/0x…"

GET/api/v1/transfers

Transfers

Decoded ERC-20 Transfer logs in the indexed window, newest first.

Parameters for Transfers
Name	In	Type	Description
page	query	integer ≥ 1	Page number. Default 1.
pageSize	query	integer 1–100	Items per page. Default 25.
token	query	0x address	Only this token.
address	query	0x address	Sender or receiver.
minValue	query	number ≥ 0	Minimum decimal-adjusted value.

Edge cache 15s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/transfers"

GET/api/v1/liquidity/pools

Liquidity pools

Pairs with reserves from getReserves(), Sync and Swap counts, and USDG-denominated TVL where one side is USDG.

Parameters for Liquidity pools
Name	In	Type	Description
page	query	integer ≥ 1	Page number. Default 1.
pageSize	query	integer 1–100	Items per page. Default 25.
token	query	0x address	Pools containing this token.
sort	query	syncs \| swaps \| tvl	Ranking. Default syncs.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/liquidity/pools"

GET/api/v1/liquidity/pools/{address}

Pool

A single pair with reserve history and recent swaps.

Parameters for Pool
Name	In	Type	Description
address*	path	0x address	Pair contract address.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/liquidity/pools/0x…"

GET/api/v1/stablecoins/usdg

USDG overview

Total supply, transfer flow series, largest and recent transfers, and USDG pools. If no contract is configured, returns observed candidates only.

Edge cache 20s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/stablecoins/usdg"

GET/api/v1/intelligence/signals

Signals

Deterministic rule-based signals with evidence, transaction hashes, confidence and methodology.

Parameters for Signals
Name	In	Type	Description
severity	query	low \| medium \| high	Filter by severity.
rule	query	large-transfer \| activity-spike \| flow-concentration \| liquidity-shift	Filter by rule.
limit	query	integer 1–80	Max signals. Default 50.

Edge cache 30s · stale-while-revalidateTry in Playground

shell

curl -s "$PRISM/api/v1/intelligence/signals"