Skip to main content
Version: 1.0

Points API

The points lookup API returns address-level BTCSWP launch point estimates. It fetches Hyperliquid fills, verifies eligible builder codes, enriches fills with the stored BTCSWP oracle mark, and applies the in-band points formula.

Market Config​

GET /points/market-config

Returns the active market multiplier, role multipliers, eligible builder codes, oracle-band gate, and daily-cap configuration used by the points indexer.

Address Lookup​

GET /points/market-address/:wallet

Returns address-level point estimates for one wallet.

Example:

curl https://nunchi.trade/points/market-address/0x1234567890abcdef1234567890abcdef12345678

Batch Address Lookup​

POST /points/market-addresses
Content-Type: application/json
{
  "addresses": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
  ]
}

Points Formula​

points(fill) = (volumeUSD / 1000) * marketMult * roleMult * proximityGate

For BTCSWP launch scoring, marketMult is 1.5, maker fills use 2.0, taker fills use 1.5, and proximityGate is 1 only when the fill is within +/-25 bps of the oracle mark at fill time.

Only fills using the Nunchi, Based, or TreadFi builder codes are attributed to points. See Nunchi Points for scoring, attribution requirements, and depth bands.