---
title: "Distribute awards"
method: POST
path: "/awards/distribute"
tags: ["Awards"]
---

# Distribute awards

`POST /awards/distribute`

Evenly distribute the purchased crypto among the specified customers.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostAwardsDistributeBody
  - `asset` 'USDC.OPTIMISM' | 'USDC.SUI' | 'DOT' | 'FIL' | 'PYUSD.ETH' | 'TRX' | 'ZRX' | 'DAI.ETH' | 'USDC.WORLDCHAIN' | 'USDP' | 'USDT.BSC' | 'USDT.CELO' | 'PEPE.ETH' | 'SAND' | 'USDC.DOTHUB' | 'USDC.SEI' | 'USDC.SOL' | 'USDC.ZKSYNC' | 'ENA.ETH' | 'MANA.ETH' | 'PYTH.SOL' | 'SOL' | 'USDC.BASE' | 'USDC.CELO' | 'USDT' | 'ADA' | 'INJ.ETH' | 'MATIC.POLYGON' | 'PAXG' | 'USD' | 'AAVE.ETH' | 'ALGO' | 'EURC.XLM' | 'KNC.ETH' | 'PNUT.SOL' | 'SHIB' | 'BCH' | 'DOGE' | 'EGLD' | 'JTO.SOL' | 'UNI.ETH' | 'USDC' | 'USDC.ARBITRUM' | 'ONDO.ETH' | 'PENGU.SOL' | 'USD' | 'WLFI.ETH' | 'XLM' | 'APT' | 'CC' | 'ETH.OPTIMISM' | 'ETH.WORLDCHAIN' | 'LDO.ETH' | 'MORPHO.ETH' | 'SEI' | 'ETH.ZKSYNC' | 'USDC.AVAX' | 'USDC.XLM' | 'USDT.DOTHUB' | 'USDT.SOL' | 'MANA' | 'USDC.ALGO' | 'MATIC.ETH' | 'NEAR' | 'UNI' | 'USDT.ARBITRUM' | 'USDT.AVAX' | 'OMG' | 'ARB.ARBITRUM' | 'COMP.ETH' | 'GRT.ETH' | 'USDC.POLYGON' | 'AVAX' | 'AAVE' | 'CELO' | 'PYUSD.SOL' | 'PAXG.ETH' | 'USDC.MONAD' | 'BAT' | 'COMP' | 'ETH.ARBITRUM' | 'ETH.BASE' | 'OP.OPTIMISM' | 'TRUMP.SOL' | 'ENJ.ETH' | 'SUI' | 'USDT.ETH' | 'USDT.OPTIMISM' | 'USDT.TRX' | 'USDT.XPL' | 'OMG.ETH' | 'XRP' | 'HBAR' | 'USDC.APT' | 'USDC.ETH' | 'BNB' | 'ATOM' | 'BAT.ETH' | 'GRT' | 'LINK.ETH' | 'USDP.SOL' | 'ZK.ZKSYNC' | 'BONK.SOL' | 'KNC' | 'TIA' | 'ZRO.ETH' | 'ZRX.ETH' | 'PUMP.SOL' | 'USD' | 'XTZ' | 'CRV.ETH' | 'GALA.ETH' | 'TON' | 'USDT.POLYGON' | 'WBTC.ETH' | 'XPL' | 'BTC' | 'MON' | 'SHIB.ETH' | 'USDC.BSC' | 'WLD.WORLDCHAIN' | 'W.SOL' | 'LTC' | 'RLUSD.ETH' | 'WBTC' | 'LINK' | 'USDCX.CANTON' | 'ETH' | 'WIF.SOL' | 'APE.ETH' | 'EURC' | 'MKR.ETH' | 'RLUSD.XRP', required — The underlying asset in the trading pair. E.g. `BTC` in the pair `BTC/USD`.
  - `quantity` string, required — The `quantity` of the `underlying` asset requested in the quote. Exactly one of `quantity` or `total` must be supplied.
  - `participant_codes` string[], required — The list of customers to receive `quantity` amount of reward
  - `quoted_currency` 'USD' | 'EUR', required — The quoted currency in the trading pair. E.g. `USD` in the pair `BTC/USD`.

## Response `201`

Successfully distributed awards. Returns a confirmation per participant containing the booked `trade_id`.

- PostAwardsDistributeResponse
  - `message` object
    - `request_id` string — The identifier of the request
    - `confirms` object[] — A list of participant_code plus trade identifiers for the executed trades confirm
      - `participant_code` string — Participant code
      - `trade_id` string — The unique identifier assigned to the trade, which is the same `trade_id` as found in a `GET /trades`

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)