Skip to main content
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"
}'

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

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"
}'

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

​
Endpoint

POSThttps://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.