> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Overview
description: Build integrations for Neverlose Marketplace items, NLE balance, webhooks, and reseller checkout.
icon: store
---

# Marketplace API

The Neverlose Marketplace is where users discover configs, scripts, and libraries
for Neverlose. The web market lets them switch products (`CS2` / `CS:GO`), filter
item types (`Configs`, `Scripts`, `Libraries`), choose paid or free listings,
search by text, sort recommendations, and open items by their market code.

The API does not replace the storefront UI. It exposes the automation points
around that marketplace: signed POST requests, item grants, NLE balance
operations, reseller checkout, webhooks for purchases and transfers, and
OAuth/OpenID identity.

## Web Market Model

<Tabs>
  <Tab title="Storefront" icon="store">
    <Columns cols={3}>
      <Card title="Products" icon="gamepad-2">
        Users switch between `CS2` and `CS:GO` markets before browsing items.
      </Card>

      <Card title="Item Types" icon="boxes">
        Listings are grouped as `Configs`, `Scripts`, and `Libraries`.
      </Card>

      <Card title="Discovery" icon="search">
        Search, sort, paid/free filters, tags, rating, and purchase/download counts shape the storefront.
      </Card>
    </Columns>
  </Tab>

  <Tab title="Listing Data" icon="list">
    <ParamField body="code" type="string" required>
      Marketplace item code shown on every listing. Item operations use this value, for example `give-for-free`.
    </ParamField>

    <ParamField body="author" type="string">
      Public author name shown near the listing title.
    </ParamField>

    <ParamField body="price" type="NLE | Free">
      Paid listings use NLE. Free listings can be distributed without charging the receiver.
    </ParamField>
  </Tab>

  <Tab title="Account Area" icon="wallet-cards">
    <Columns cols={2}>
      <Card title="Balance" icon="coins">
        The web UI shows NLE balance and funds on hold. API methods and webhooks expose balance-related events.
      </Card>

      <Card title="History" icon="receipt-text">
        My items, purchases, transactions, and purchase history represent the account-side activity around items.
      </Card>
    </Columns>
  </Tab>
</Tabs>

## What the API Covers

<Columns cols={2}>
  <Card title="Requests" icon="send" href="/market/api-requests/api-requests">
    Send signed JSON POST requests to `user-api.neverlose.cc/api/market/<method>`.
  </Card>

  <Card title="Items" icon="package-check">
    Grant your own paid scripts, configs, and libraries by `code` at no cost to the receiver.
  </Card>

  <Card title="Balance" icon="coins">
    Read NLE balance and, for official resellers, transfer NLE to users.
  </Card>

  <Card title="Products" icon="badge-check">
    Gift CS2 or CS:GO subscriptions, read product prices, and check invite/user state.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/market/webhooks/webhooks">
    Receive signed callbacks for balance transfers and item purchases.
  </Card>

  <Card title="Reseller Checkout" icon="handshake" href="/market/reseller-integration/reseller-integration">
    Add reseller payment methods, publish prices, and handle `nl_purchase` JWT redirects.
  </Card>
</Columns>

## Integration Flow

<Steps>
  <Step title="Open API settings" icon="settings">
    Get your `user_id`, secret key, webhook URLs, and reseller settings from the market API settings page.
  </Step>

  <Step title="Build request body" icon="braces">
    Add method-specific fields such as `username`, `code`, `amount`, `product`, or `cnt`.
  </Step>

  <Step title="Sign the payload" icon="shield-check">
    Generate `signature` from the sorted request fields and your secret key.
  </Step>

  <Step title="Send the request" icon="send">
    POST JSON to `user-api.neverlose.cc/api/market/<method>`.
  </Step>

  <Step title="Validate callbacks" icon="webhook">
    Check signatures on every incoming webhook before processing the event.
  </Step>
</Steps>

## Start Here

<Columns cols={3}>
  <Card title="Getting Started" icon="rocket" href="/market/overview/getting-started">
    Make the first signed request and see the expected response shape.
  </Card>

  <Card title="API Reference" icon="code" href="/market/api/post-give-for-free">
    Browse generated endpoint pages for items, balance, products, and users.
  </Card>

  <Card title="Signatures" icon="shield-check" href="/market/authentication/signatures">
    Reuse the same signing model for outgoing requests and incoming webhooks.
  </Card>
</Columns>
