Skip to main content
GET
/
transactions
cURL
curl --request GET \
  --url https://api.otim.com/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
  "instructionIds": [
    "0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9"
  ],
  "from": "2021-01-01T00:00:00Z",
  "to": "2021-01-01T00:00:00Z",
  "skip": 123,
  "take": 123,
  "sort": "Ascending"
}'
[
  {
    "createdAtUnix": 1716150000,
    "updatedAtUnix": 1716150000,
    "transactionHash": "0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9",
    "chainId": 11155111,
    "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
    "instructionId": "0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9",
    "startedAtUnix": 1716150000,
    "finishedAtUnix": 1716150000,
    "startedAtBlock": 1716150000,
    "finishedAtBlock": 1716150000,
    "blockHash": "0x94fbe8788b93f18275955b725ddf5432f4d4d9a279d70e1c508bee558922e21a",
    "activation": true,
    "deactivation": false,
    "transactionStatus": "Success"
  }
]

Authorizations

​
Authorization
string
header
required

JWT token for API authentication

Body

application/json
​
address
string<address>

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

​
instructionIds
string<bytes32>[]
Example:
[
  "0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9"
]
​
from
string<date-time>
Example:

"2021-01-01T00:00:00Z"

​
to
string<date-time>
Example:

"2021-01-01T00:00:00Z"

​
skip
integer | null
​
take
integer | null
​
sort
enum<string>
Available options:
Ascending,
Descending
Example:

"Ascending"

Response

200 - application/json

Transactions retrieved successfully

​
createdAtUnix
integer

Unix timestamp of when the document was created

Example:

1716150000

​
updatedAtUnix
integer

Unix timestamp of when the document was last updated

Example:

1716150000

​
transactionHash
string<bytes32>

Hash of the transaction

Example:

"0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9"

​
chainId
integer

Chain ID of the transaction

Example:

11155111

​
address
string<address>

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

​
instructionId
string<bytes32>

Instruction ID of the Instruction submitted in the transaction

Example:

"0x97fbe0031494c55eb0e1d182988e110af02f5db3adb95065733e7dc8447581f9"

​
startedAtUnix
integer

Unix timestamp of when the transaction was started

Example:

1716150000

​
finishedAtUnix
integer

Unix timestamp of when the transaction finished

Example:

1716150000

​
startedAtBlock
integer

Block number when the transaction was started

Example:

1716150000

​
finishedAtBlock
integer

Block number when the transaction finished

Example:

1716150000

​
blockHash
string<bytes32>

Hash of the block the transaction was included in

Example:

"0x94fbe8788b93f18275955b725ddf5432f4d4d9a279d70e1c508bee558922e21a"

​
activation
boolean

True if the transaction was an Instruction activation

Example:

true

​
deactivation
boolean

True if the transaction was an Instruction deactivation

Example:

false

​
transactionStatus
enum<string>
Available options:
Pending,
InFlight,
Success,
Error
Example:

"Success"