Skip to content

API Reference / Steam accounts

Create multiple Steam accounts at once

Import a batch of Steam accounts in a single call. Each account succeeds or fails independently, and the response reports the outcome for every submitted row.

POST/steam.v1.Steam/BulkCreateAccounts

Request body

application/jsonRequired

Request to import a batch of Steam accounts in one call. Each row succeeds or fails independently.

accounts?array<BulkCreateAccountInput>

The accounts to create, at least one and at most 500 rows per call. Each succeeds or fails independently.

Show attributes
accountNamestring

Unique Steam account name within the workspace.

identitySecret?string

Base64 identity secret used to confirm Steam mobile trade confirmations. May be omitted, in which case the row is still accepted (see CreateAccountRequest.identity_secret for the runtime consequence).

passwordstring

The Steam account's login password.

sharedSecretstring

Base64 shared secret used to generate the account's Steam Guard mobile authenticator codes.

Response body

application/json

Success

results?array<BulkCreateAccountResult>

One result per submitted row, in the same order as the request.

Show attributes
account?Account

The created account. Unset when this row failed - see error.

Show attributes
accountName?string

Unique Steam account name within the workspace.

apiKeyConfigured?boolean

Whether the account has its own account-tier Steam Web API key configured. Never the key itself.

apiKeySaved?AccountSecretSaved

When the account's own Steam Web API key was last saved and by whom. Unset when none is saved, and for a key saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

avatarUrl?string

Full-size Steam profile picture of the account, from its most recently observed persona. Unset until Steam has provided the account's avatar.

banSeverity?string

What the account's bans mean for trading, derived from the ban fields: stops trading for an economy ban, trade lock or community ban, a warning for a VAC ban, game ban or economy probation, otherwise none.

Value in"ACCOUNT_BAN_SEVERITY_NONE""ACCOUNT_BAN_SEVERITY_WARNING""ACCOUNT_BAN_SEVERITY_STOPS_TRADING"

capabilities?array<string>

Opt-in per-market trading actions this account may perform. Always empty when is_scraping is true.

Value in"ACCOUNT_CAPABILITY_CSFLOAT_BUY_ORDER""ACCOUNT_CAPABILITY_CSFLOAT_OFFER""ACCOUNT_CAPABILITY_CSFLOAT_SELL""ACCOUNT_CAPABILITY_CSFLOAT_AUCTION_BID"

communityBanned?boolean

Whether the Steam account is community banned.

createdAt?string

When the account was added to the workspace. Unset for accounts added before the platform recorded it.

Format"date-time"

deletedAt?string

When the account was soft deleted. Unset for an active account.

Format"date-time"

economyBan?string

Steam economy ban state: none, probation, or banned.

generation?string

Persistent account lifecycle generation. Changes on creation or restoration, remains stable across sessions and ordinary updates. Zero means the producer does not provide an authoritative generation.

Format"int64"

identitySecretConfigured?boolean

Whether a mobile authenticator identity secret is saved for the account, so trade and market confirmations can be accepted. Never the secret itself.

identitySecretSaved?AccountSecretSaved

When the confirmation (identity) secret was last saved and by whom. Unset when none is saved, and for a secret saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

inventoryCheckedAt?string

When the account's community inventory was last successfully fetched. Unset when the inventory has never been fetched.

Format"date-time"

inventoryPrivateSince?string

When the account's community inventory was first observed as private. Unset when the inventory is readable.

Format"date-time"

isLimited?boolean

Whether Steam reports the account as limited, meaning it has not spent the minimum on Steam and cannot use some community and trading features.

isScraping?boolean

Cross-market scraping toggle. A scraping account may only be used for read-only operations on any market, never to hold buying balance, place a buy order or offer, bid an auction, or list inventory for sale.

lastSessionError?string

Steam EResult name of the most recent session error. Not cleared on recovery, so it stays the last-error breadcrumb until overwritten by the next error.

locked?boolean

Whether the Steam account is trade and market locked.

loginRetryAt?string

When a login-throttle cooldown ends and the next sign-in may be attempted. Unset when the account is not cooling down.

Format"date-time"

loginStatus?string

What the account's Steam session means for the operator, derived by the server from session_status and session_error_reason.

Value in"LOGIN_STATUS_LOGGED_IN""LOGIN_STATUS_RETRYING""LOGIN_STATUS_FAILED""LOGIN_STATUS_LOGGED_OUT"

numberOfGameBans?integer

Number of game bans on the Steam account.

Format"int32"

passwordSaved?AccountSecretSaved

When the password was last saved and by whom. Unset for a password saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

personaName?string

Most recently observed self-persona display name. Unset until Steam explicitly provides the account's name. Separate from its login username.

personaObservedAt?string

When Steam explicitly provided the self-persona state. Name-only and avatar-only updates do not refresh this state observation clock.

Format"date-time"

personaState?string

Most recently explicitly observed self-persona state. Zero is observed Offline. Unset means unknown. Last-known presence is separate from current connection status.

Value in"PERSONA_STATE_OFFLINE""PERSONA_STATE_ONLINE""PERSONA_STATE_BUSY""PERSONA_STATE_AWAY""PERSONA_STATE_SNOOZE""PERSONA_STATE_LOOKING_TO_TRADE""PERSONA_STATE_LOOKING_TO_PLAY"

reconnectCount?integer

Number of reconnects made within the current session establishment. Resets to 0 on each new session start.

Format"int32"

requestLatency?string

Latest measured correlated Steam request-to-first-response round trip in milliseconds, including server processing. Observed zero is valid. Unset means unmeasured. Separate from logon latency.

requestLatencyObservedAt?string

Original response time of the latest passively measured request round trip. Best-effort projection, separate from current connection and collection freshness.

Format"date-time"

sessionConnectedAt?string

When the account's current online stretch began: the logon that brought it online, kept across a reconnect or a move to another worker that logs on again within five minutes of going offline. Unset until the first logon.

Format"date-time"

sessionDisconnectedAt?string

When the account last went offline: moves when a logged-on account drops and stays put while an offline account keeps failing to sign in. Kept after it comes back online. Compare with session_connected_at.

Format"date-time"

sessionErrorReason?string

Typed cause of the most recent session error. Unset until a session has errored. Like last_session_error it is not cleared on recovery.

Value in"SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED""SESSION_ERROR_REASON_PROXY_POOL_UNAVAILABLE""SESSION_ERROR_REASON_PROXY_UNREACHABLE""SESSION_ERROR_REASON_PROXY_AUTHENTICATION_FAILED""SESSION_ERROR_REASON_CREDENTIALS_REJECTED""SESSION_ERROR_REASON_ACCOUNT_RESTRICTED""SESSION_ERROR_REASON_LOGIN_THROTTLED""SESSION_ERROR_REASON_STEAM_UNAVAILABLE""SESSION_ERROR_REASON_WEB_SESSION_FAILED""SESSION_ERROR_REASON_INTERNAL"

sessionErrorUserFixable?boolean

Whether the customer can fix the account's current session error themselves, such as by updating its password or assigning a proxy. False when the session is not in error.

sessionLatency?string

Most recent logon round-trip latency in milliseconds. Unset until the session's first successful logon.

sessionStatus?string

Current Steam session lifecycle state.

Value in"SESSION_STATUS_DISCONNECTED""SESSION_STATUS_CONNECTING""SESSION_STATUS_CONNECTED""SESSION_STATUS_LOGGED_ON""SESSION_STATUS_ERROR"

sharedSecretSaved?AccountSecretSaved

When the Steam Guard shared secret was last saved and by whom. Unset for a secret saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

steamCreatedAt?string

When the Steam account itself was made, as Steam reports it. Unset until it has been read, and for an account whose Steam profile is private.

Format"date-time"

steamId?string

The account's 64-bit SteamID. Unset until the account has logged on at least once.

tradeOfferCheckedAt?string

When the current trade-offer list was last completely fetched and persisted in this account lifecycle, including a successful empty list. Unset until the first complete check. Separate from initial historical synchronization.

Format"date-time"

tradeOfferHistorySyncError?string

Bounded reason the scheduled history synchronization is waiting to retry. No recorded error when unspecified. Successful pages clear it without resetting progress.

Value in"TRADE_OFFER_HISTORY_SYNC_ERROR_ACCESS_DENIED""TRADE_OFFER_HISTORY_SYNC_ERROR_RATE_LIMITED""TRADE_OFFER_HISTORY_SYNC_ERROR_RETRYING"

tradeOfferHistorySyncedAt?string

When initial synchronization consumed all historical offer pages returned by Steam. Unset while pending or incomplete. Not a guarantee of lifetime history retention.

Format"date-time"

vacBanned?boolean

Whether the Steam account has a VAC ban.

workspaceId?string

Workspace the account belongs to.

Format"byte" base64

error?BulkCreateAccountError

The failure reason. Unset when this row succeeded - see account.

Show attributes
code?string

Machine-readable failure reason for this row.

Value in"BULK_CREATE_ACCOUNT_ERROR_CODE_ALREADY_EXISTS""BULK_CREATE_ACCOUNT_ERROR_CODE_INVALID""BULK_CREATE_ACCOUNT_ERROR_CODE_INTERNAL"

message?string

Human-readable failure detail for this row.

curl -X POST "https://api.goldmine.to/steam.v1.Steam/BulkCreateAccounts" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [
      {
        "accountName": "trader_bot_01",
        "password": "hunter2pass",
        "sharedSecret": "sharedSecretBase64Value==",
        "identitySecret": "identitySecretBase64Value=="
      },
      {
        "accountName": "trader_bot_02",
        "password": "hunter3pass",
        "sharedSecret": "anotherSharedSecret==",
        "identitySecret": "anotherIdentitySecret=="
      }
    ]
  }'
{
  "results": [
    {
      "account": {
        "accountName": "trader_bot_01",
        "workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ==",
        "sessionStatus": "SESSION_STATUS_DISCONNECTED",
        "communityBanned": false,
        "locked": false,
        "vacBanned": false,
        "numberOfGameBans": 0,
        "economyBan": "none"
      }
    },
    {
      "error": {
        "code": "BULK_CREATE_ACCOUNT_ERROR_CODE_ALREADY_EXISTS",
        "message": "account already exists"
      }
    }
  ]
}