The NERFS
field guide
The data pipeline, wallet interface and execution boundaries behind NERFS
Collection analytics, sale history, NFT selection and Ethereum wallet connectivity
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
Every number has a source
Collection metadata, floor price, volume and sale events are retrieved from the OpenSea API ↗
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
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
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
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
- Define the reference index
Specify eligible venues, currency conversion, liquidity filters, outlier handling, wash-trade controls and stale-data behavior - Secure a market listing
Verify the exact venue, network, market identifier, collateral asset and custody path - Operate the oracle
Use monitored publication, independent validation and explicit halt conditions
The current OpenSea display feed is not approved as a settlement oracle - Provide liquidity and risk limits
Set leverage, open-interest caps and liquidation rules based on tested market depth - 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
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
| Field | Content |
|---|---|
| collection | Verified slug, Ethereum contract and marketplace URL |
| floor / day / rates | Source-denominated market metrics and USD conversions |
| sales | Deduplicated executions with transaction hash and token identifier |
| nfts | Recently traded tokens, artwork paths and marketplace links |
| source | Fetch timestamp, most recent sale timestamp and stale state |
| execution | Current 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
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
It is not a settlement oracle or a promise of liquidity
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
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