Sign in
accs v1

List accounts of a player.

Changed on

Returns a list of accounts for the given player.

This object represents a player's account, which is a blockchain smart account that can be used to interact with the blockchain.

The accounts are returned sorted by creation date, with the most recently created accounts appearing first.

Returns the latest 10 transaction intents for each account.

By default, a maximum of 10 accounts are shown per page.

get/v1/accounts

Request

  • Base URL: https://api.openfort.io
  • URL: https://api.openfort.io/v1/accounts
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Query parameters

limitinteger

Specifies the maximum number of records to return.

skipinteger

Specifies the offset for the first records to return.

order'asc' | 'desc'

Specifies the order in which to sort the results.

chainIdinteger

The chain ID. Must be a supported chain.

playerstring

Specifies the unique player ID (starts with pla_)

addressstring

Specifies the address of the account

expandAccountResponseExpandable[]

Specifies the fields to expand in the response.

Response

Successful response.

object'list' required
urlstring required
startinteger required
endinteger required
totalinteger required

Example response

{
  "data": [
    {
      "transactionIntents": [
        {
          "chainId": 5,
          "details": {
            "from": "0x8ab66318aCC6b29A27e74e534bfe3ecf81C50387",
            "data": "0x8c5a...",
            "nonce": "0",
            "gas": "21000",
            "maxFeePerGas": "1000000000",
            "maxPriorityFeePerGas": "1000000000",
            "value": "0x8ab66318aCC6b29A27e74e534bfe3ecf81C50387"
          },
          "response": {
            "error": {
              "reason": "AA31: paymaster deposit too low",
              "name": "ExecutionResult",
              "explanation": {
                "cause": "The paymaster does not have enough native tokens deposited in the EntryPoint to cover the gas cost.",
                "solution": "Top up your account balance in the dashboard or deposit more to the Paymaster contract on the relevant chain."
              }
            }
          },
          "finalCost": "0.42",
          "interactions": [
            {
              "value": "1000000000000000000",
              "contract": "con_0cddb398-1dc6-4e6f-8726-9ec7cea85f35",
              "functionName": "mint",
              "functionArgs": [
                "0x662D24Bf7Ea2dD6a7D0935F680a6056b94fE934d"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Changes

  • 5019a5edea73Revision changes
    • info

      removed from the //////// response property anyOf list for the response status

    • info

      removed the zkSync enum value from the //////// response property for the response status

  • 88be7ccfca19Revision changes
    • breaking

      the ///////// response's property type changed from no type to object for status

    • info

      the endpoint scheme security auth_token was added to the API

    • info

      the endpoint scheme security better_auth was removed from the API

    • info

      the security scope accounts:read was added to the endpoint's security scheme sk

    • info

      added the optional property //////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the required property ////////// to the response with the status