NERFS.FAMILY / TECHNICAL DOCUMENTATION

The NERFS
field guide

The data pipeline, wallet interface and execution boundaries behind NERFS

Operational

Collection analytics, sale history, NFT selection and Ethereum wallet connectivity

Not deployed

A CREDITS perpetual market, collateral vault, funding engine and liquidation service

This application reads the Credits collection on Ethereum and routes individual NFT purchases to OpenSea
The application does not custody funds or submit leveraged orders

VERIFIED COLLECTION CONTRACT / ETHEREUM0x97630aa70ab14ed9883b41dafccbc11349723043 ↗
02 / MARKET DATA

Every number has a source

Collection metadata, floor price, volume and sale events are retrieved from the OpenSea API ↗

01OpenSeaMetadata & sale events
02Read adapterValidation & deduplication
03Market snapshot15-second cache
04Interface20-second polling

Robinhood token market

The separate token panel follows contract 0x39679b59289cce7c7f6e0feacdf39a1e543de751 on Robinhood Chain
This is not the Ethereum NFT collection contract and no relationship between the assets is assumed

Without an API key, the server reads structured public data embedded in the linked OpenSea page every 30 seconds
It extracts price, 24-hour change, volume, valuation, supply, holders and verification status
When OpenSea uses FDV as a market-cap estimate, the interface labels that explicitly
Public-page extraction depends on OpenSea’s page format and fails visibly if that format changes

With OPENSEA_API_KEY configured on the server, the panel uses the official token details, OHLCV and activity endpoints
The 1H view requests one-minute candles, 6H requests five-minute candles and 1D requests fifteen-minute candles
Missing candle periods are not filled
Without historical API access, the line only displays prices observed since the page opened and is labelled accordingly
Swap history remains unavailable until API access succeeds

Metric definitions

Floor
The collection floor reported by OpenSea, not a perpetual mark price or an executable quote
USD conversion
Native values converted using the matching currency rate in OpenSea collection metadata
Rates refresh approximately once per minute
24h volume & sales
The provider’s one_day collection interval, with its own currency symbol preserved
Since open
The change in observed collection floor since this page was opened
It is not a historical 24-hour return
Sale chart
Observed ETH and WETH sale executions, ordered by timestamp
Different NFTs can trade at different prices because their traits differ
The chart is not a floor index or a liquidation oracle
Across sample
The percentage change from the first to the last sale in the displayed sample
This does not measure the return of a single asset

Coverage & freshness

The adapter requests the latest 50 sale events per refresh, or 200 when a server API key is configured and keeps up to 2,000 deduplicated observations in server memory
The time controls filter this available sample and do not promise complete historical coverage
Restarting the server resets the accumulated sample

Connected means the most recent provider request succeeded
A quiet market can return unchanged values
If an update fails, the last known snapshot remains visible as Stale feed with its original update time
Unavailable data is shown as a dash rather than replaced with generated numbers

03 / WALLET & FUNDING

Your keys stay in your wallet

The interface discovers browser wallets through EIP-6963 ↗ and communicates through EIP-1193 ↗

  • Connecting requests your public address through eth_requestAccounts
  • Network and balance use eth_chainId and eth_getBalance
  • Account changes, network changes and disconnect events update the interface
  • Balance is refreshed every 15 seconds while the page is visible
  • No seed phrase, private key, token approval or signature is requested by this version

Receiving funds

Receive ETH displays the address of your connected wallet on Ethereum mainnet
Transfers to that address fund your own wallet for marketplace purchases
This is not a deposit into a NERFS trading account or collateral vault

WalletConnect and mobile QR pairing are not included in this build
Use a browser with an injected Ethereum wallet

04 / EXECUTION

From artwork to ownership

Selecting a Credit changes the artwork, token identifier, historical last sale and destination purchase link
The gallery is built from recently traded NFTs, not from a list of guaranteed active listings

Buy on OpenSea opens the verified collection contract and selected token
Current availability, price, fees and the transaction confirmation are handled on OpenSea in your wallet
A historical sale does not create a fillable order

The Perpetuals panel remains unavailable until a real venue is integrated
The NFT collection contract is not a collateral vault and must never be used as a deposit destination

05 / PROPOSED ARCHITECTURE

A path to CREDITS perps

This section is a launch design, not a claim that a perpetual protocol is deployed or audited

A collection-wide price index is the proposed underlying, rather than a separate leveraged market for each NFT
Individual token trades are too heterogeneous to substitute directly for a robust collection index

Execution venue

Hyperliquid HIP-3 ↗ supports builder-deployed perpetual markets with operator-defined oracles and market parameters
The documented self-operated mainnet requirement is 500,000 staked HYPE, maintained for at least 183 days after deployment
An existing operator is another possible integration route, subject to that operator accepting and listing CREDITS

nftperp V2 ↗ also documents NFT perpetual APIs and an execution SDK
Its current market availability and support for CREDITS have not been verified for this deployment

Required before enabling orders

  1. Define the reference index
    Specify eligible venues, currency conversion, liquidity filters, outlier handling, wash-trade controls and stale-data behavior
  2. Secure a market listing
    Verify the exact venue, network, market identifier, collateral asset and custody path
  3. Operate the oracle
    Use monitored publication, independent validation and explicit halt conditions
    The current OpenSea display feed is not approved as a settlement oracle
  4. Provide liquidity and risk limits
    Set leverage, open-interest caps and liquidation rules based on tested market depth
  5. Verify the full funds lifecycle
    Test deposit, order signing, partial fills, cancellation, liquidation and withdrawal on the chosen venue’s test environment before mainnet

Collateral routing and signed order submission are intentionally absent until these dependencies exist
There is no deployed NERFS collateral address or audit report to cite

06 / API REFERENCE

A small, read-only surface

GET /api/token-market?window=1H

Returns Robinhood token metrics, available candles and swaps, source timestamp and per-feed availability
Allowed windows are 1H, 6H and 1D
No API key is returned to the browser

GET /api/market

Returns a normalized collection snapshot
Errors return HTTP 503 when no previous snapshot is available

FieldContent
collectionVerified slug, Ethereum contract and marketplace URL
floor / day / ratesSource-denominated market metrics and USD conversions
salesDeduplicated executions with transaction hash and token identifier
nftsRecently traded tokens, artwork paths and marketplace links
sourceFetch timestamp, most recent sale timestamp and stale state
executionCurrent execution availability with perpetuals set to false

GET /api/nft-image/:id

Loads artwork only for a token returned by the verified collection feed
Image sources are restricted to HTTPS OpenSea CDN domains and a 2 MB response limit
SVG is served with a sandboxed content security policy

08 / RISK FRAMEWORK

The price is only one part

Collection analytics help describe a market, but they do not remove the risks of owning NFTs or trading leveraged instruments

Collection and liquidity risk

Individual NFTs are not interchangeable at a single price
Traits, provenance and buyer preferences can create large differences between sales
A displayed floor can move when a listing is removed, even without an execution
Past sales do not guarantee that a position can be exited at a similar price

Data and index risk

Marketplace feeds can be delayed, incomplete or unavailable
Repeated transactions, unusual sales and activity between related wallets require scrutiny before data can be used in a financial index
The current read adapter validates format and collection membership but does not claim to detect wash trading

Leverage and liquidation

A leveraged position can lose its collateral when margin falls below a venue’s maintenance requirement
Funding, trading fees and slippage affect the outcome independently of the direction of the index
No leverage limit, liquidation formula or fee schedule is offered for a live NERFS market because no such market is connected

Wallet and execution risk

Check the network, token, destination and terms shown by your wallet before confirming any transaction
NFT purchases are executed through OpenSea and inherit the risks of the marketplace, the underlying contracts and the asset itself

The analytics feed is an observation tool
It is not a settlement oracle or a promise of liquidity
09 / GLOSSARY

A shared market vocabulary

Floor price
A collection-level listing metric reported by the source
It is distinct from the last traded price of any selected NFT
Index price
A benchmark calculated under a published methodology
A future collection index needs rules for eligible data, weighting and exceptional conditions
Mark price
A venue-defined reference used to value positions and assess margin
No perpetual mark price is displayed by this release
Funding
Periodic payments between long and short positions under the venue’s rules, intended to help align perpetual and reference prices
Open interest
Outstanding derivative positions on a venue
NFT sales volume is not open interest and cannot substitute for it
Collateral
Assets assigned to support a margin position
ETH in a connected personal wallet is not automatically trading collateral
Oracle
A mechanism that publishes reference data to an execution system
The display feed in this application does not perform this function
Slippage
The difference between an expected execution price and the price achieved
It generally becomes more significant when available liquidity is thin
07 / OPERATIONS

Explicit boundaries

The Node server serves the interface and proxies read-only OpenSea requests
An optional OPENSEA_API_KEY can be configured in the server environment if required by the provider
The key is never sent to the browser

The server has no order-signing key, deposit endpoint or transaction submission API
Wallet keys remain in the wallet extension
Market data is cached in memory and is not a permanent trade archive

Credits artwork and the collection contract belong to their respective creators and rights holders
This interface does not claim endorsement, partnership, protocol audits or guarantees of liquidity

Return to the market