Submitting a batch of transfers (conveniently)

Submitting a batch of transfers (conveniently)

cURL

curl --request POST \
  --url https://waitlist-api.prod.blast.io/v1/contracts/{contractAddress}/batches \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pointType": "<string>",
  "transfers": [
    {
      "toAddress": "<string>",
      "points": "<string>"
    }
  ],
  "secondsToFinalize": 123
}
'

200

{
  "success": true,
  "batchId": "<string>"
}

This API is the same as the idempotent transfer API above, but if you don’t need the idempotency, you can use this POST API and avoid providing your own batchIds.

Authentication

Authorization · string · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Params

contractAddress · string · required

Contract address distributing the points.

Request

pointType · string · required

Point type to distribute, can be PHASE2_POINTS or PHASE2_GOLD

transfers · Transfer[] · required

List of transfers to submitted as part of the batch.

Show child attributes

toAddress · string · required

Points receiver

points · string · required

Amount of points to distribute to toAddress.

Must be >= MINIMUM_{pointType}_TRANSFER_SIZE and must have decimal places <= MAX_TRANSFER_DECIMALS

secondsToFinalize · number

Number of seconds to wait before finalizing this batch, must be between MINIMUM_FINALIZE_SECONDS and DEFAULT_FINALIZE_SECONDS.

If not present uses DEFAULT_FINALIZE_SECONDS

Response

success · boolean

Response status

batchId · string

Transfer batch batchId that can be used to fetch it’s status.