> For the complete documentation index, see [llms.txt](https://sonic-ai-works.gitbook.io/sonic-networks-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sonic-ai-works.gitbook.io/sonic-networks-docs/api-reference/sonic-api-reference/token-sale-and-market-status-api.md).

# Token Sale & Market Status API

Preview SONIC API contracts for planned Q4 2026 pre-sale publication, launchpad/provider verification, eligibility/access handoff, disclosures, DEX liquidity and routing status.

**Status: Preview · Sale state: Planned / Q4 2026 target**

SONIC currently plans to use an external audited/approved launchpad such as **PinkSale or Smithii.io** rather than allowing the product API to custody contribution funds directly. The API therefore owns **publication, eligibility, canonical provider handoff, status and reconciliation projections** while the approved launchpad/contract owns sale execution.

## Public reads

```http
GET /api/v1/token-sales/current
GET /api/v1/token-sales/{saleId}
GET /api/v1/token-sales/{saleId}/disclosures
GET /api/v1/token-sales/{saleId}/verification
GET /api/v1/token-sales/{saleId}/markets
```

### `GET /token-sales/current`

Returns the active/planned sale projection or `null` when there is no publishable sale.

```json
{
  "saleId": "sale_01...",
  "stage": "PRE_SALE",
  "status": "PLANNED",
  "targetWindow": "Q4 2026",
  "provider": null,
  "providerCandidates": ["PinkSale", "Smithii"],
  "allocationMinAtomic": "3000000000000000000",
  "allocationMaxAtomic": "5000000000000000000",
  "presalePriceUsd": "0.000002",
  "initialDexReferenceUsd": "0.0000025",
  "productionMint": null,
  "updatedAt": "2026-09-07T00:00:00Z"
}
```

Planning values must carry `status = PLANNED`; they cannot be presented as funded, open or executable.

## Verification projection

`GET /api/v1/token-sales/{saleId}/verification` separates configuration from proof.

```json
{
  "provider": { "configured": false, "verified": false },
  "saleContract": { "address": null, "verified": false },
  "productionMint": { "address": null, "verified": false },
  "inventory": { "funded": false, "reconciled": false },
  "terms": { "published": false, "version": null },
  "liquidity": { "verified": false },
  "activationAllowed": false
}
```

## Eligibility and provider handoff

A future authenticated endpoint may create a **sale access intent** without taking custody:

```http
POST /api/v1/token-sales/{saleId}/access-intents
GET  /api/v1/token-sales/access-intents/{accessIntentId}
```

The server evaluates account/session state, jurisdiction/eligibility policy when applicable, sale window and canonical provider URL. It returns a short-lived handoff only when the sale is verified and open.

```
signed session
→ eligibility/policy
→ verified saleId + provider configuration
→ short-lived canonical handoff
→ external launchpad
```

The API must never return a mock provider URL as a Live sale link.

## Market status

`GET /api/v1/token-sales/{saleId}/markets` reports only approved/verified market observations:

```json
{
  "launchReferenceUsd": "0.0000025",
  "launchReferenceStatus": "PLANNED",
  "venues": [
    { "venue": "Raydium", "kind": "POOL", "status": "PLANNED", "address": null },
    { "venue": "Meteora", "kind": "POOL", "status": "PLANNED", "address": null },
    { "venue": "Orca", "kind": "POOL", "status": "PLANNED", "address": null },
    { "venue": "Jupiter", "kind": "AGGREGATOR", "status": "PLANNED", "routeAvailable": false }
  ]
}
```

Jupiter is classified as `AGGREGATOR`, not a direct pool venue.

## Binance fields

```json
{
  "binance": { "status": "TBA", "verified": false },
  "binanceAlpha": { "status": "TBA", "verified": false }
}
```

No endpoint may imply endorsement or listing from a configured marketing field.

## Sale state enum

Recommended domain states:

```
DRAFT
PROVIDER_EVALUATION
POLICY_APPROVED
INVENTORY_FUNDED
CONFIGURED
SECURITY_REVIEW
VERIFIED
ANNOUNCED
OPEN
CLOSED
FINALIZING
SUCCESS
FAILED
ALLOCATED
CLAIMABLE
DISTRIBUTING
DEX_BOOTSTRAP
LIQUIDITY_VERIFIED
ROUTABLE
REFUNDABLE
REFUNDING
REFUNDED
RECONCILED
PAUSED
CANCELLED
REQUIRES_REVIEW
```

## Risk/disclosure rule

Every public sale projection links or embeds the current disclosure version. Clients must not hide the facts that prices can fall, liquidity can disappear, listings are not guaranteed and token-sale participation may be restricted by jurisdiction.

## Idempotency

If SONIC later adds contributor mutations, each logical financial operation must use durable idempotency and expected-effect verification. Provider transaction IDs/signatures remain evidence/correlation values and never replace SONIC business IDs.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sonic-ai-works.gitbook.io/sonic-networks-docs/api-reference/sonic-api-reference/token-sale-and-market-status-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.