Public API

RiftVault API Docs

Read-only public API to query marketplace data. Generate an API key in your developer dashboard.

Authentication

All requests must include your API key in the X-API-Key header.

curl https://riftvault.io/api/v1/nfts \
  -H "X-API-Key: rv_your_key_here"

Rate limit: 60 requests per minute per key. Exceeding returns HTTP 429.

GET/api/v1/nfts

List active NFT listings.

Query params

limit (max 100)offsetcollection (slug)rarity

GET/api/v1/collections

List all collections with floor price and NFT count.

Webhooks

Subscribe to marketplace events via HTTP POST. Payloads are signed with HMAC-SHA256 — verify using the X-RiftVault-Signature header and your webhook secret.

order.completed

offer.received

withdrawal.approved

airdrop.claimable

Configure webhooks in your developer settings.