Skip to main content
Submitting a batch of transfers (idempotently)
curl --request PUT \
  --url https://waitlist-api.prod.blast.io/v1/contracts/{contractAddress}/batches/{batchId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "pointType": "<string>",
  "transfers": [
    {
      "toAddress": "<string>",
      "points": "<string>"
    }
  ],
  "secondsToFinalize": 123
}'
{
  "success": true,
  "batchId": "<string>"
}
The points API accepts transfers in batches. For efficiency, try to completely fill your batches. This API expects you to provide a client generated batchId to uniquely identify this batch of transfers.

​
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.
​
batchId
string
required
batchId is a client provided string (max length 64). If a request fails, the request can be retried with the same batchId. If the batchId already exists, we return a 409.We recommend using a UUID as batchId.

​
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.
​
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 which was provided as a param.