Reservoir API

Aggregated NFT liquidity and trading API that normalizes listings, bids, and sales data across all major NFT marketplaces (OpenSea, Blur, X2Y2, LooksRare) into a single unified interface.

Evaluated Mar 06, 2026 (0d ago) vv1

Homepage ↗ Repo ↗ Finance nft blockchain ethereum marketplace aggregator web3 liquidity

⚙ Agent Friendliness

/ 100

Can an agent use this?

🔒 Security

/ 100

Is it safe for agents?

⚡ Reliability

/ 100

Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality

Documentation

Error Messages

Auth Simplicity

Rate Limits

🔒 Security

TLS Enforcement

100

Auth Strength

Scope Granularity

Dep. Hygiene

Secret Handling

TLS enforced. Open-source SDK (reservoir-kit) allows inspection. API key auth with no scope granularity. OpenAPI spec published which enables security tooling integration.

⚡ Reliability

Uptime/SLA

Version Stability

Breaking Changes

Error Recovery

Best When

An agent needs the best available NFT price or wants to execute trades across multiple marketplaces without maintaining separate integrations.

Avoid When

Use case is analytics-only and cross-marketplace aggregation is not needed; OpenSea or Blur direct API is simpler.

Use Cases

• Cross-marketplace NFT floor price and best-offer discovery
• Aggregated buy/sell execution across multiple marketplaces from one API call
• Real-time NFT collection activity feeds and sales normalization
• Automated NFT trading agents needing best-price routing
• Portfolio valuation using aggregated bid and ask data

Not For

• Non-NFT blockchain data (DeFi, token swaps)
• Chains with no Reservoir marketplace integration
• Projects needing creator royalty enforcement by default (varies by marketplace)

Interface

REST API

Yes

GraphQL

gRPC

MCP Server

SDK

Yes

Webhooks

Yes

OpenAPI Spec ↗

Authentication

Methods: api_key

OAuth: No Scopes: No

API key passed via x-api-key header. Public endpoints available without key but heavily rate-limited. Free keys available via self-serve signup.

Pricing

Model: freemium

Free tier: Yes

Requires CC: No

Generous free tier. OpenAPI spec available for code generation. Self-hosted option via open-source relay.

Agent Metadata

Pagination

cursor

Idempotent

True

Retry Guidance

Documented

Known Gotchas

⚠ Marketplace liquidity varies by chain; Ethereum mainnet has best coverage
⚠ Buy/sell execution requires agent wallet signing — not just API calls
⚠ Cross-marketplace fills may partially succeed; agents must handle partial fill states
⚠ Listing data freshness depends on marketplace sync intervals (can be 30-60s behind)
⚠ Royalty enforcement behavior differs by underlying marketplace; agents must account for variable take rates

Alternatives

opensea-api nansen-api alchemy-api

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Reservoir API.

$99

API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-06.