Fund Your Account - Polymarket Documentation

Fund the Perps account with pUSD before placing orders. Deposits move pUSD from the user’s Polymarket wallet into the Perps account. Withdrawals move available pUSD back to the authenticated wallet.

Deposit Collateral

Deposit pUSD when the account needs collateral for opening or maintaining Perps positions.

TypeScript
Python
API

Create a Secure Client

Create a SecureClient for the wallet that will fund the Perps account. If you already have a Polymarket wallet, pass it as wallet and include a Relayer API key so the SDK can submit gasless transactions. If you are creating a wallet programmatically, use a Builder API key so the SDK can create the Deposit Wallet for that signer.

import { createSecureClient, relayerApiKey } from "@polymarket/client";
import { privateKey } from "@polymarket/client/viem";

const client = await createSecureClient({
  wallet: process.env.POLYMARKET_WALLET_ADDRESS!,
  signer: privateKey(process.env.PRIVATE_KEY!),
  apiKey: relayerApiKey({
    key: process.env.RELAYER_API_KEY!,
    address: process.env.RELAYER_API_KEY_ADDRESS!,
  }),
});

Set Up Deposit Approvals

Set up the approvals required for Perps collateral deposits. The SDK skips work that is already complete.

await client.setupTradingApprovals();

Deposit Collateral

Deposit pUSD from the user’s Polymarket wallet into the Perps account. Make sure the wallet has pUSD before depositing. The minimum Perps deposit is 10 pUSD. Amounts use raw pUSD base units, so 10 pUSD is 10_000_000n.

const deposit = await client.depositToPerps({
  amount: 10_000_000n,
});

const receipt = await deposit.wait();
// receipt.transactionHash: TxHash

deposit.wait() confirms that the chain transaction settled. Perps may take a moment to credit the account after that.

Verify the Deposit

Open a Perps session and read account state after the deposit settles.

const session = await client.openPerpsSession();

try {
  const portfolio = await session.fetchPortfolio();
  const deposits = await session.listDeposits().firstPage();
} finally {
  await session.close();
}

Use portfolio.withdrawable to check available collateral and deposits.items to reconcile deposit history.

Create a Secure Client

Create an AsyncSecureClient for the wallet that will fund the Perps account. If you already have a Polymarket wallet, pass it as wallet and include a Relayer API key so the SDK can submit gasless transactions. If you are creating a wallet programmatically, use a Builder API key so the SDK can create the Deposit Wallet for that signer.

import os

from polymarket import AsyncSecureClient, RelayerApiKey

client = await AsyncSecureClient.create(
    private_key=os.environ["PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
    api_key=RelayerApiKey(
        key=os.environ["RELAYER_API_KEY"],
        address=os.environ["RELAYER_API_KEY_ADDRESS"],
    ),
)

Set Up Deposit Approvals

Set up the approvals required for Perps collateral deposits. The SDK skips work that is already complete.

await client.setup_trading_approvals()

Deposit Collateral

deposit = await client.deposit_to_perps(amount=10_000_000)

receipt = await deposit.wait()
# receipt.transaction_hash: TransactionHash

deposit.wait() confirms that the chain transaction settled. Perps may take a moment to credit the account after that.

Verify the Deposit

Open a Perps session and read account state after the deposit settles.

session = await client.open_perps_session()

try:
    portfolio = await session.fetch_portfolio()
    deposits = await session.list_deposits().first_page()
finally:
    await session.close()

Use portfolio.withdrawable to check available collateral and deposits.items to reconcile deposit history.

Check Deposit Approval

Before depositing, the Polymarket wallet must approve the Perps deposit contract to spend pUSD. If the approval is already in place, skip the approval call.

Approval Call

pUSD.approve(PerpsDepositContract, maxUint256)

Use these contract addresses when building the approval call.

Contract	Address
pUSD collateral token	`0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB`
Perps deposit contract	`0xDCa4af75705dbB50f62437045afF9921947917d2`

The following steps show the Deposit Wallet batch path. If you are trading with a Safe or Poly Proxy wallet, use an SDK that handles the wallet-specific transaction flow for you.

Build the Deposit Call

Create the Perps deposit call. Deposit amounts use pUSD base units, so 10 pUSD is 10000000.

function deposit(address token, uint256 amount, address to);

Encode the deposit calldata with these arguments.

Argument	Value
`token`	`0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB`
`amount`	`10000000`
`to`	Signer address for the Polymarket account.

Build the final ordered call list. Include the approval call first only when approval is needed.

[
  {
    "target": "0xDCa4af75705dbB50f62437045afF9921947917d2",
    "value": "0",
    "data": "<deposit_calldata>"
  }
]

Fetch a Relayer Nonce

Fetch a fresh WALLET nonce before submitting the Deposit Wallet batch.

curl -G "https://relayer-v2.polymarket.com/v1/account/transactions/params" \
  -H "RELAYER_API_KEY: $RELAYER_API_KEY" \
  -H "RELAYER_API_KEY_ADDRESS: $RELAYER_API_KEY_ADDRESS" \
  --data-urlencode "address=<polymarket_account_signer_address>" \
  --data-urlencode "type=WALLET"

The response includes the nonce to sign with the batch.

{
  "address": "<polymarket_account_signer_address>",
  "nonce": "<wallet_nonce>"
}

Build the Deposit Wallet Batch

Build the EIP-712 Batch typed data for the Deposit Wallet. Use the final ordered call list from the previous step, and omit the approval call when allowance is already sufficient. Set deadline to a Unix timestamp in seconds after which the relayer should reject the batch.

{
  "domain": {
    "name": "DepositWallet",
    "version": "1",
    "chainId": 137,
    "verifyingContract": "<polymarket_wallet_address>"
  },
  "primaryType": "Batch",
  "types": {
    "Call": [
      { "name": "target", "type": "address" },
      { "name": "value", "type": "uint256" },
      { "name": "data", "type": "bytes" }
    ],
    "Batch": [
      { "name": "wallet", "type": "address" },
      { "name": "nonce", "type": "uint256" },
      { "name": "deadline", "type": "uint256" },
      { "name": "calls", "type": "Call[]" }
    ]
  },
  "message": {
    "wallet": "<polymarket_wallet_address>",
    "nonce": "<wallet_nonce>",
    "deadline": "<unix_seconds>",
    "calls": [
      {
        "target": "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
        "value": "0",
        "data": "<approve_calldata>"
      },
      {
        "target": "0xDCa4af75705dbB50f62437045afF9921947917d2",
        "value": "0",
        "data": "<deposit_calldata>"
      }
    ]
  }
}

Sign this typed data with the signer for the Polymarket account.

Submit the Deposit Transaction

Submit the signed batch to the Relayer API. Use the same ordered call list you signed in the previous step.

curl -X POST "https://relayer-v2.polymarket.com/submit" \
  -H "Content-Type: application/json" \
  -H "RELAYER_API_KEY: $RELAYER_API_KEY" \
  -H "RELAYER_API_KEY_ADDRESS: $RELAYER_API_KEY_ADDRESS" \
  -d '{
    "type": "WALLET",
    "from": "<polymarket_account_signer_address>",
    "to": "0x00000000000Fb5C9ADea0298D729A0CB3823Cc07",
    "nonce": "<wallet_nonce>",
    "signature": "<wallet_batch_signature>",
    "metadata": "Deposit pUSD to Perps",
    "depositWalletParams": {
      "depositWallet": "<polymarket_wallet_address>",
      "deadline": "<unix_seconds>",
      "calls": [
        {
          "target": "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
          "value": "0",
          "data": "<approve_calldata>"
        },
        {
          "target": "0xDCa4af75705dbB50f62437045afF9921947917d2",
          "value": "0",
          "data": "<deposit_calldata>"
        }
      ]
    }
  }'

The response includes the relayer transaction ID.

{
  "transactionID": "<transaction_id>",
  "state": "STATE_NEW"
}

Poll the Deposit Transaction

Poll the relayer transaction until it reaches STATE_CONFIRMED before relying on the deposited collateral.

curl "https://relayer-v2.polymarket.com/v1/account/transactions/<transaction_id>" \
  -H "RELAYER_API_KEY: $RELAYER_API_KEY" \
  -H "RELAYER_API_KEY_ADDRESS: $RELAYER_API_KEY_ADDRESS"

{
  "transaction_id": "<transaction_id>",
  "transaction_hash": "<transaction_hash>",
  "state": "STATE_CONFIRMED",
  "error_msg": null
}

Perps may take a moment to credit the account after the onchain transaction settles. Treat STATE_FAILED and STATE_INVALID as terminal failures.

Withdraw Collateral

Withdraw pUSD when the account has available collateral that should return to the authenticated wallet.

TypeScript
Python
API

Request a withdrawal to the authenticated wallet. Amounts use raw pUSD base units, so 10 pUSD is 10_000_000n.

const withdrawalId = await client.withdrawFromPerps({
  amount: 10_000_000n,
});

The SDK signs the withdrawal request with the Polymarket account signer and returns the Perps withdrawal ID.To track the withdrawal, open a Perps session and list withdrawals.

const session = await client.openPerpsSession();

try {
  const withdrawals = await session.listWithdrawals().firstPage();
} finally {
  await session.close();
}

For more details on authenticated sessions, see Authenticated Sessions.

Request a withdrawal to the authenticated wallet. Amounts use raw pUSD base units, so 10 pUSD is 10_000_000.

withdrawal_id = await client.withdraw_from_perps(amount=10_000_000)

The SDK signs the withdrawal request with the Polymarket account signer and returns the Perps withdrawal ID.To track the withdrawal, open a Perps session and list withdrawals.

session = await client.open_perps_session()

try:
    withdrawals = await session.list_withdrawals().first_page()
finally:
    await session.close()

For more details on authenticated sessions, see Authenticated Sessions.

Build the Withdrawal Operation

Create a withdraw operation with the account signer, pUSD token, raw token amount, and destination wallet. For withdrawals, amount is the raw pUSD token amount, so 10 pUSD is 10000000.

{
  "type": "withdraw",
  "args": {
    "account": "<polymarket_account_signer_address>",
    "token": "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
    "amount": "10000000",
    "to": "<polymarket_wallet_address>"
  }
}

Field	Value
`account`	Signer address for the Polymarket account.
`token`	pUSD collateral token address.
`amount`	Raw pUSD token amount.
`to`	Wallet that receives the withdrawal.

Create Withdrawal Typed Data

The withdrawal signature uses EIP-712 typed data with Withdraw as the primary type. Use the same account, token, amount, and to values from the withdrawal operation.For withdrawals, ts is a Unix timestamp in seconds because the onchain contract validates it against block.timestamp. It must match the ts value in the request body.

{
  "domain": {
    "name": "Polymarket",
    "version": "1",
    "chainId": 137,
    "verifyingContract": "0xDCa4af75705dbB50f62437045afF9921947917d2"
  },
  "primaryType": "Withdraw",
  "types": {
    "Withdraw": [
      { "name": "account", "type": "address" },
      { "name": "token", "type": "address" },
      { "name": "amount", "type": "uint256" },
      { "name": "fee", "type": "uint256" },
      { "name": "to", "type": "address" },
      { "name": "salt", "type": "uint64" },
      { "name": "ts", "type": "uint64" }
    ]
  },
  "message": {
    "account": "<polymarket_account_signer_address>",
    "token": "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
    "amount": "10000000",
    "fee": "0",
    "to": "<polymarket_wallet_address>",
    "salt": 555555555,
    "ts": 1767000014
  }
}

Field	Value
`salt`	Random integer generated for this signed request.
`ts`	Current Unix timestamp in seconds, not milliseconds.

Sign Withdrawal Typed Data

Sign the typed data with the Polymarket account signer. The example below uses Viem.

Viem

import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("<polymarket_account_signer_private_key>");

const signature = await account.signTypedData({
  domain: {
    name: "Polymarket",
    version: "1",
    chainId: 137,
    verifyingContract: "0xDCa4af75705dbB50f62437045afF9921947917d2",
  },
  primaryType: "Withdraw",
  types: {
    Withdraw: [
      { name: "account", type: "address" },
      { name: "token", type: "address" },
      { name: "amount", type: "uint256" },
      { name: "fee", type: "uint256" },
      { name: "to", type: "address" },
      { name: "salt", type: "uint64" },
      { name: "ts", type: "uint64" },
    ],
  },
  message: {
    account: "<polymarket_account_signer_address>",
    token: "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
    amount: 10000000n,
    fee: 0n,
    to: "<polymarket_wallet_address>",
    salt: 555555555n,
    ts: 1767000014n,
  },
});

Submit the Withdrawal

Submit the signed withdrawal request to POST /v1/account/withdraw. Use the same operation values, salt, and ts from the typed data.

curl -X POST "https://api.perpetuals.polymarket.com/v1/account/withdraw" \
  -H "content-type: application/json" \
  -d '{
    "op": {
      "type": "withdraw",
      "args": {
        "account": "<polymarket_account_signer_address>",
        "token": "0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB",
        "amount": "10000000",
        "to": "<polymarket_wallet_address>"
      }
    },
    "sig": "<signature>",
    "salt": 555555555,
    "ts": 1767000014
  }'

The response indicates whether the withdrawal was accepted.

{
  "status": "ok",
  "withdraw_id": 1234567890
}

Track the Withdrawal

Use the returned withdraw_id to match the withdrawal against history results.

curl -G "https://api.perpetuals.polymarket.com/v1/account/withdrawals" \
  -H "polymarket-proxy: <proxy_address>" \
  -H "polymarket-secret: <proxy_secret>" \
  --data-urlencode "withdrawal_status=pending"

For more details on proxy credentials and private account-read headers, see Authenticated Sessions.

Review Funding History

Use deposit and withdrawal history to reconcile collateral movements after your integration submits funding requests. See Authenticated Sessions for how to create an authenticated session for private account history reads.

TypeScript
Python
API

List deposit or withdrawal history from an authenticated Perps session.

import type { PerpsDeposit } from "@polymarket/client";

const session = await client.openPerpsSession();

try {
  const deposits: PerpsDeposit[] = [];

  for await (const page of session.listDeposits()) {
    deposits.push(...page.items);
  }
} finally {
  await session.close();
}

List deposit or withdrawal history from an authenticated Perps session.

session = await client.open_perps_session()

try:
    deposits = []

    async for page in session.list_deposits():
        deposits.extend(page.items)
finally:
    await session.close()

List deposit history.

curl -G "https://api.perpetuals.polymarket.com/v1/account/deposits" \
  -H "polymarket-proxy: <proxy_address>" \
  -H "polymarket-secret: <proxy_secret>"

List withdrawal history.

curl -G "https://api.perpetuals.polymarket.com/v1/account/withdrawals" \
  -H "polymarket-proxy: <proxy_address>" \
  -H "polymarket-secret: <proxy_secret>"

Use the optional deposit_status, withdrawal_status, start_timestamp, and end_timestamp query parameters when reconciling a specific window.

​Deposit Collateral

​Withdraw Collateral

​Review Funding History

Deposit Collateral

Withdraw Collateral

Review Funding History