Deposit

Move settlement funds into available app balance

cURL

curl --request POST \
  --url https://api.longshot.xyz/v1/users/deposit \
  --header 'Authorization: Bearer <session_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_micros": 1000000,
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000"
}'

200

{
  "amount_micros": "1000000",
  "operation_id": "550e8400-e29b-41d4-a716-446655440000",
  "tx_hash": "0xdemo_user_deposit_tx"
}

cURL

curl --request POST \
  --url https://api.longshot.xyz/v1/users/deposit \
  --header 'Authorization: Bearer <session_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_micros": 1000000,
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000"
}'

200

{
  "amount_micros": "1000000",
  "operation_id": "550e8400-e29b-41d4-a716-446655440000",
  "tx_hash": "0xdemo_user_deposit_tx"
}

Endpoint

POST

https://api.longshot.xyz/v1/users/deposit

POST https://api.longshot.xyz/v1/users/deposit
Authorization: Bearer <session_token>
Content-Type: application/json

Moves funds from the user’s onchain settlement balance into Longshot available app balance. Custodial deposit environments normally use GET /v1/users/deposit-wallet and the automatic deposit listener instead of manual client deposit calls. Demo environments may return demo transaction hashes.

Headers

Authorization · string · required

Bearer <session_token> from wallet auth or Privy session auth.

Body Parameters

amount_micros · int64 · required

Amount to post from settlement balance, in USDC micros. Minimum is 1.

idempotency_key · uuid · required

Client-supplied idempotency key for replay-safe submission.

Response Fields

amount_micros · string

Amount credited into available app balance, in USDC micros, encoded as a decimal integer string.

operation_id · uuid

Operation ID used for idempotency and recovery correlation.

tx_hash · string

Transaction hash for the settlement deposit.