openapi: 3.1.0 info: version: 3.0.0 title: Platform Server Accounts Transactions API description: 'The platform server is an internal component. It should be hosted in a private network and should not be accessible from the Internet. This server enables the business to fetch and update the state of transactions using its API. ' license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://platform-server.exampleanchor.com tags: - name: Transactions description: Transactions initiated by client applications via SEP APIs paths: /transactions: get: tags: - Transactions x-seps: - SEP-6 - SEP-24 - SEP-31 summary: Retrieve a List of Transactions operationId: getTransactions description: Allows to query list of transactions for desired SEP. This api supports pagination, and it's possible (and recommended) to make multiple requests to query transactions. The last page is reached when the number of elements returned by the endpoint is smaller than provided `page_size`. parameters: - in: query name: sep required: true schema: type: string enum: - '6' - '24' - '31' description: Lookup transactions belonging to this SEP. - in: query name: order_by schema: type: string enum: - created_at - transfer_received_at - user_action_required_by default: created_at description: 'Specifies field that transactions will be ordered by. Note, that secondary sort is transaction id in ascending value. I.e. when timestamps for 2 or more transactions is identical, they will be sorted by id.' - in: query name: order schema: type: string enum: - asc - desc default: asc description: 'Specifies order. Note, that when the field is null, all transactions with null value will be last, regardless of soring order (NULLS LAST). For example, transfer time may not be specified for some transactions, resulting into `transfer_received_at` being null. If so, transactions with non-null values will be sorted and returned first, followed by all transactions with null timestamps.' - in: query name: statuses schema: type: array items: $ref: '#/components/schemas/StatusSEPAll' description: Filters transactions for specified array of statuses. If not provided, filtering is disabled (default behavior) - in: query name: page_size schema: type: integer default: 20 description: Size of a single search page. Must be positive. - in: query name: page_number schema: type: integer default: 0 description: Page number to use for continuous search. Page count beings at 0. responses: '200': description: Transaction found. content: application/json: schema: oneOf: - $ref: '#/components/schemas/TransactionListSEP6' - $ref: '#/components/schemas/TransactionListSEP24' - $ref: '#/components/schemas/TransactionListSEP31' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Transaction not found. content: application/json: schema: $ref: '#/components/schemas/Error' post: tags: - Transactions summary: Submit a Transaction description: 'This endpoint actually submits a transaction to the Stellar network. It only takes a single, required parameter: the signed transaction. Refer to the Transactions page for details on how to craft a proper one. If you submit a transaction that has already been included in a ledger, this endpoint will return the same response as would’ve been returned for the original transaction submission. This allows for safe resubmission of transactions in error scenarios, as highlighted in the error-handling guide.' operationId: SubmitATransaction parameters: - in: query name: tx schema: type: string description: The base64-encoded XDR of the transaction. required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SubmitTransaction' examples: SubmitaTransaction: $ref: '#/components/examples/SubmitaTransaction' /transactions/{id}: get: tags: - Transactions x-seps: - SEP-6 - SEP-24 - SEP-31 summary: Retrieve a Transaction operationId: getTransaction description: Provides the information necessary for the business to determine the state of the transaction identified by `id`, decide if any action must be taken to continue processing the transaction, and act on the decision. parameters: - in: path name: id required: true schema: type: string responses: '200': description: Transaction found. content: application/json: schema: oneOf: - $ref: '#/components/schemas/TransactionSEP6' - $ref: '#/components/schemas/TransactionSEP24' - $ref: '#/components/schemas/TransactionSEP31' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Transaction not found. content: application/json: schema: $ref: '#/components/schemas/Error' /transactions/{transaction_hash}: get: tags: - Transactions summary: Retrieve a Transaction description: The single transaction endpoint provides information on a specific transaction. operationId: RetrieveATransaction parameters: - $ref: '#/components/parameters/HashParam' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/schemas-Transaction' examples: RetrieveATransaction: $ref: '#/components/examples/RetrieveATransaction' /transactions/{transaction_hash}/operations: get: tags: - Transactions summary: Retrieve a Transaction's Operations description: This endpoint returns Successful operations for a specific transaction. operationId: RetrieveATransactionsOperations parameters: - $ref: '#/components/parameters/HashParam' - $ref: '#/components/parameters/CursorParam' - $ref: '#/components/parameters/OrderParam' - $ref: '#/components/parameters/LimitParam' - $ref: '#/components/parameters/IncludeFailedParam' - $ref: '#/components/parameters/JoinParam' responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/Links' - $ref: '#/components/schemas/Operation' examples: RetrieveATransactionsOperations: $ref: '#/components/examples/RetrieveATransactionsOperations' /transactions/{transaction_hash}/effects: get: tags: - Transactions summary: Retrieve a Transaction's Effects description: This endpoint returns the effects of a specific transaction. operationId: RetrieveATransactionsEffects parameters: - $ref: '#/components/parameters/HashParam' - $ref: '#/components/parameters/CursorParam' - $ref: '#/components/parameters/OrderParam' - $ref: '#/components/parameters/LimitParam' responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/Links' - $ref: '#/components/schemas/Effect' examples: RetrieveATransactionsEffects: $ref: '#/components/examples/RetrieveATransactionsEffects' /transactions_async: post: summary: Submit a Transaction Asynchronously description: This endpoint submits transactions to the Stellar network asynchronously. It is designed to allow users to submit transactions without blocking them while waiting for a response from Horizon. At the same time, it also provides clear response status codes from stellar-core to help understand the status of the submitted transaction. You can then use Horizon's [GET transaction endpoint](https://developers.stellar.org/docs/data/apis/horizon/api-reference/resources/retrieve-a-transaction) to wait for the transaction to be included in a ledger and ingested by Horizon. operationId: SubmitAsyncTransaction tags: - Transactions parameters: - in: query name: tx schema: type: string description: The base64-encoded XDR of the transaction. required: true responses: '201': description: Transaction has been received by core and is in pending status. content: application/json: schema: $ref: '#/components/schemas/AsyncTransactionSubmissionResponse' examples: TransactionPending: summary: Transaction Pending value: tx_status: PENDING hash: 6cbb7f714bd08cea7c30cab7818a35c510cbbfc0a6aa06172a1e94146ecf0165 '400': description: Transaction is malformed; ERROR status from core. content: application/json: schema: oneOf: - $ref: '#/components/schemas/AsyncTransactionSubmissionResponse' - $ref: '#/components/schemas/Problem' examples: TransactionMalformed: summary: Transaction Malformed value: type: transaction_malformed title: Transaction Malformed status: 400 detail: Horizon could not decode the transaction envelope in this request. A transaction should be an XDR TransactionEnvelope struct encoded using base64. The envelope read from this request is echoed in the `extras.envelope_xdr` field of this response for your convenience. extras: envelope_xdr: '' TransactionError: summary: ERROR Status from core value: error_result_xdr: AAAAAAAAAGT////7AAAAAA== tx_status: ERROR hash: 6cbb7f714bd08cea7c30cab7818a35c510cbbfc0a6aa06172a1e94146ecf0165 '403': description: Transaction submission has been disabled for Horizon. content: application/json: schema: $ref: '#/components/schemas/Problem' examples: TransactionSubmissionDisabled: summary: Transaction Submission Disabled value: type: transaction_submission_disabled title: Transaction Submission Disabled status: 403 detail: Transaction submission has been disabled for Horizon. To enable it again, remove env variable DISABLE_TX_SUB. extras: envelope_xdr: '' '409': description: Transaction is a duplicate of a previously submitted transaction. content: application/json: schema: $ref: '#/components/schemas/AsyncTransactionSubmissionResponse' examples: TransactionDuplicate: summary: Transaction Duplicate value: tx_status: DUPLICATE hash: 6cbb7f714bd08cea7c30cab7818a35c510cbbfc0a6aa06172a1e94146ecf0165 '500': description: Transaction submission failure, exception or invalid status from core. content: application/json: schema: $ref: '#/components/schemas/Problem' examples: TransactionFailed: summary: Transaction Submission Failed value: type: transaction_submission_failed title: Transaction Submission Failed status: 500 detail: 'Could not submit transaction to stellar-core. The `extras.error` field on this response contains further details. Descriptions of each code can be found at: https://developers.stellar.org/api/errors/http-status-codes/horizon-specific/transaction-submission-async/transaction_submission_failed' extras: envelope_xdr: '' error: Error details here TransactionException: summary: Transaction Submission Exception value: type: transaction_submission_exception title: Transaction Submission Exception status: 500 detail: 'Received exception from stellar-core. The `extras.error` field on this response contains further details. Descriptions of each code can be found at: https://developers.stellar.org/api/errors/http-status-codes/horizon-specific/transaction-submission-async/transaction_submission_exception' extras: envelope_xdr: '' error: Exception details here TransactionInvalidStatus: summary: Transaction Submission Invalid Status value: type: transaction_submission_invalid_status title: Transaction Submission Invalid Status status: 500 detail: 'Received invalid status from stellar-core. The `extras.error` field on this response contains further details. Descriptions of each code can be found at: https://developers.stellar.org/api/errors/http-status-codes/horizon-specific/transaction-submission-async/transaction_submission_invalid_status' extras: envelope_xdr: '' error: Error details here '503': description: History DB is stale; core is unavailable for transaction submission. content: application/json: schema: oneOf: - $ref: '#/components/schemas/AsyncTransactionSubmissionResponse' - $ref: '#/components/schemas/Problem' examples: HistoryDBStale: summary: Historical DB Is Too Stale value: type: stale_history title: Historical DB Is Too Stale status: 503 detail: This horizon instance is configured to reject client requests when it can determine that the history database is lagging too far behind the connected instance of Stellar-Core or read replica. It's also possible that Stellar-Core is out of sync. Please try again later. extras: envelope_xdr: '' TransactionTryAgainLater: summary: TRY_AGAIN_LATER Status from core value: tx_status: TRY_AGAIN_LATER hash: 6cbb7f714bd08cea7c30cab7818a35c510cbbfc0a6aa06172a1e94146ecf0165 components: schemas: id: type: string FeeDetails: type: object required: - total - asset properties: total: type: string asset: type: string details: type: array items: $ref: '#/components/schemas/FeeDescription' StatusSEPAll: type: string description: Possible status values for all transactions enum: - incomplete - completed - refunded - expired - error - pending_stellar - pending_external - pending_user_transfer_start - pending_user_transfer_complete - pending_anchor - pending_trust - pending_user - no_market - too_small - too_large - pending_sender - pending_receiver - pending_transaction_info_update - pending_customer_info_update paging_token: type: string TransactionListSEP31: type: object properties: records: type: array items: $ref: '#/components/schemas/TransactionSEP31' Error: type: object properties: error: type: string id: type: string required: - error Refunds: type: object properties: amount_refunded: $ref: '#/components/schemas/Amount' amount_fee: $ref: '#/components/schemas/Amount' payments: type: array items: type: object properties: id: type: string id_type: type: string enum: - stellar - external amount: $ref: '#/components/schemas/Amount' fee: $ref: '#/components/schemas/Amount' requested_at: type: string format: date-time refunded_at: type: string format: date-time MemoType: type: string description: The memo type of the transaction in the Stellar network. Should be present if memo is not null. enum: - text id hash Links: type: object properties: _links: type: object properties: self: $ref: '#/components/schemas/link' next: $ref: '#/components/schemas/link' prev: $ref: '#/components/schemas/link' Operation: type: object properties: _links: type: object properties: effects: $ref: '#/components/schemas/link' precedes: $ref: '#/components/schemas/link' self: $ref: '#/components/schemas/link' succeds: $ref: '#/components/schemas/link' transaction: $ref: '#/components/schemas/link' id: $ref: '#/components/schemas/id' paging_token: $ref: '#/components/schemas/paging_token' type_i: type: number example: 0 type: type: string example: create_account StatusSEP24: type: string description: Possible status value for SEP-24 transactions enum: - incomplete - completed - refunded - expired - error - pending_stellar - pending_external - pending_user_transfer_start - pending_user_transfer_complete - pending_anchor - pending_trust - pending_user - no_market - too_small - too_large InnerTransaction: type: object properties: hash: $ref: '#/components/schemas/hash' signatures: $ref: '#/components/schemas/signatures' max_fee: type: string Amount: type: object required: - amount - asset properties: amount: type: string asset: type: string FeeDescription: type: object required: - name - amount properties: name: type: string amount: type: string description: type: string StellarId: type: object description: 'StellarId''s are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors. For a SEP-12 customer, the `id` field should be sufficient to fully identify the customer in the business'' Backend. For a SEP-31 Sending Anchor, the `account` and `memo` fields should be used. For a SEP-6 or SEP-24 Anchor, the `account` and `memo` fields should be used. ' properties: id: type: string description: The `id` of the customer registered through SEP-12. account: type: string description: Either the Stellar account or Muxed account address of the on-chain entity. memo: type: string description: The memo value identifying a customer with a shared account, where the shared account is `account`. TransactionSEP31: type: object required: - id - sep - kind - status - started_at properties: id: type: string sep: type: string enum: - '31' kind: type: string enum: - receive status: $ref: '#/components/schemas/StatusSEP31' type: type: string description: This field is always empty for SEP-31 transactions. amount_expected: $ref: '#/components/schemas/Amount' amount_in: $ref: '#/components/schemas/Amount' amount_out: $ref: '#/components/schemas/Amount' fee_details: $ref: '#/components/schemas/FeeDetails' quote_id: type: string started_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: string format: date-time transfer_received_at: type: string format: date-time user_action_required_by: type: string format: date-time message: type: string refunds: $ref: '#/components/schemas/Refunds' stellar_transactions: type: array items: $ref: '#/components/schemas/StellarTransaction' source_account: type: string destination_account: type: string external_transaction_id: type: string memo: type: string memo_type: $ref: '#/components/schemas/MemoType' refund_memo: description: if provided, this memo should be used for refund transactions. type: string refund_memo_type: $ref: '#/components/schemas/MemoType' client_domain: type: string client_name: type: string customers: type: object description: 'The Identification info of the sending and receiving customers. If they were created through [SEP-12](https://stellar.org/protocol/sep-12), this object should contain the SEP-12 customer `id`. Otherwise, the `account` address of the customer. ' properties: sender: $ref: '#/components/schemas/StellarId' receiver: $ref: '#/components/schemas/StellarId' creator: $ref: '#/components/schemas/StellarId' StatusSEP31: type: string description: Possible status value for SEP-31 transactions enum: - incomplete - completed - refunded - expired - error - pending_stellar - pending_external - pending_sender - pending_receiver - pending_transaction_info_update - pending_customer_info_update TransactionSEP6: type: object required: - id - sep - kind - status - started_at properties: id: type: string sep: type: string enum: - '6' kind: type: string enum: - deposit - deposit-exchange - withdrawal - withdrawal-exchange status: $ref: '#/components/schemas/StatusSEP6' type: type: string description: The method the user used to deposit or withdraw offchain funds. amount_expected: $ref: '#/components/schemas/Amount' amount_in: $ref: '#/components/schemas/Amount' amount_out: $ref: '#/components/schemas/Amount' fee_details: $ref: '#/components/schemas/FeeDetails' quote_id: type: string started_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: string format: date-time transfer_received_at: type: string format: date-time user_action_required_by: type: string format: date-time message: type: string refunds: $ref: '#/components/schemas/Refunds' stellar_transactions: type: array items: $ref: '#/components/schemas/StellarTransaction' source_account: type: string destination_account: type: string external_transaction_id: type: string memo: type: string memo_type: $ref: '#/components/schemas/MemoType' refund_memo: type: string description: If provided, this memo should be used for refund transactions. refund_memo_type: $ref: '#/components/schemas/MemoType' client_domain: type: string client_name: type: string customers: type: object description: 'The user that initiated the transaction is both the sender and receiver. ' properties: sender: $ref: '#/components/schemas/StellarId' receiver: $ref: '#/components/schemas/StellarId' creator: $ref: '#/components/schemas/StellarId' hash: type: string SubmitTransaction: type: object properties: _embedded: type: object properties: records: type: array items: type: object properties: memo: type: string memo_bytes: type: string _links: type: object properties: self: $ref: '#/components/schemas/link' account: $ref: '#/components/schemas/link' ledger: $ref: '#/components/schemas/link' operations: $ref: '#/components/schemas/link' effects: $ref: '#/components/schemas/link' precedes: $ref: '#/components/schemas/link' succeeds: $ref: '#/components/schemas/link' transaction: $ref: '#/components/schemas/link' required: - self - account - ledger - operations - effects - precedes - succeeds - transaction id: $ref: '#/components/schemas/id' paging_token: type: string successful: type: boolean hash: type: string ledger: type: integer format: int32 created_at: type: string source_account: $ref: '#/components/schemas/address' account_muxed: type: string account_muxed_id: type: string source_account_sequence: type: string fee_account: $ref: '#/components/schemas/address' fee_account_muxed: $ref: '#/components/schemas/address' fee_account_muxed_id: type: string fee_charged: type: string max_fee: type: string operation_count: type: integer format: int32 envelope_xdr: type: string result_xdr: type: string result_meta_xdr: type: string fee_meta_xdr: type: string memo_type: type: string signatures: $ref: '#/components/schemas/signatures' preconditions: $ref: '#/components/schemas/TransactionPreconditions' fee_bump_transaction: $ref: '#/components/schemas/FeeBumpTransaction' inner_transaction: $ref: '#/components/schemas/InnerTransaction' required: - id - paging_token - successful - hash - ledger - created_at - source_account - source_account_sequence - fee_account - fee_charged - max_fee - operation_count - envelope_xdr - result_xdr - result_meta_xdr - memo_type - signatures signatures: type: array items: type: string pattern: G[A-Z0-9]{55} TransactionListSEP6: type: object properties: records: type: array items: $ref: '#/components/schemas/TransactionSEP6' AsyncTransactionSubmissionResponse: type: object properties: error_result_xdr: type: string nullable: true description: TransactionResult XDR string which is present only if the submission status from core is an ERROR. tx_status: type: string enum: - ERROR - PENDING - DUPLICATE - TRY_AGAIN_LATER description: Status of the transaction submission. hash: type: string description: Hash of the transaction. schemas-Transaction: type: object properties: _links: type: object properties: self: $ref: '#/components/schemas/link' account: $ref: '#/components/schemas/link' ledger: $ref: '#/components/schemas/link' operations: $ref: '#/components/schemas/link' effects: $ref: '#/components/schemas/link' precedes: $ref: '#/components/schemas/link' succeeds: $ref: '#/components/schemas/link' required: - self - account - ledger - operations - effects - precedes - succeeds id: $ref: '#/components/schemas/id' paging_token: type: string successful: type: boolean hash: type: string ledger: type: integer format: int32 created_at: type: string source_account: $ref: '#/components/schemas/address' account_muxed: type: string account_muxed_id: type: string source_account_sequence: type: string fee_account: $ref: '#/components/schemas/address' fee_account_muxed: $ref: '#/components/schemas/address' fee_account_muxed_id: type: string fee_charged: type: string max_fee: type: string operation_count: type: integer format: int32 envelope_xdr: type: string result_xdr: type: string result_meta_xdr: type: string fee_meta_xdr: type: string memo_type: type: string signatures: $ref: '#/components/schemas/signatures' FeeBumpTransaction: type: object properties: hash: $ref: '#/components/schemas/hash' signatures: $ref: '#/components/schemas/signatures' StatusSEP6: type: string description: Possible status value for SEP-6 transactions enum: - incomplete - completed - refunded - expired - error - pending_stellar - pending_external - pending_customer_info_update - pending_user_transfer_start - pending_user_transfer_complete - pending_anchor - pending_trust - pending_user - no_market - too_small - too_large address: type: string pattern: G[A-Z0-9]{55} TransactionSEP24: type: object required: - id - sep - kind - status - amount_expected - destination_account - started_at properties: id: type: string sep: type: string enum: - '24' kind: type: string enum: - deposit - withdrawal status: $ref: '#/components/schemas/StatusSEP24' type: type: string description: This field is always empty for SEP-24 transactions. amount_expected: $ref: '#/components/schemas/Amount' amount_in: $ref: '#/components/schemas/Amount' amount_out: $ref: '#/components/schemas/Amount' fee_details: $ref: '#/components/schemas/FeeDetails' quote_id: type: string started_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: string format: date-time transfer_received_at: type: string format: date-time user_action_required_by: type: string format: date-time message: type: string refunds: $ref: '#/components/schemas/Refunds' stellar_transactions: type: array items: $ref: '#/components/schemas/StellarTransaction' source_account: type: string destination_account: type: string external_transaction_id: type: string memo: type: string memo_type: $ref: '#/components/schemas/MemoType' refund_memo: description: If provided, this memo should be used for refund transactions. type: string refund_memo_type: $ref: '#/components/schemas/MemoType' client_domain: type: string client_name: type: string customers: type: object description: 'The user that initiated the transaction is both the sender and receiver. ' properties: sender: $ref: '#/components/schemas/StellarId' receiver: $ref: '#/components/schemas/StellarId' creator: $ref: '#/components/schemas/StellarId' StellarTransaction: type: object required: - id - created_at - envelope - payments properties: id: type: string description: The ID of the transaction in the Stellar network. memo: type: string description: The memo of the transaction in the Stellar network. memo_type: type: string description: The memo type of the transaction in the Stellar network. Should be present if memo is not null. enum: - text - hash - id created_at: type: string format: date-time description: The time the transaction was registered in the Stellar network. envelope: type: string description: The transaction envelope, containing all the transaction information. payments: type: array items: type: object required: - id - payment_type - source_account - destination_account - amount properties: id: type: string description: The ID of the payment in the Stellar Network. payment_type: type: string description: The type of payment in the Stellar Network. enum: - payment - path_payment default: payment source_account: type: string description: The account being debited in the Stellar Network. destination_account: type: string description: The account being credited in the Stellar Network. amount: $ref: '#/components/schemas/Amount' TransactionPreconditions: type: object properties: timebounds: $ref: '#/components/schemas/TransactionPreconditionsTimebounds' ledgerbounds: $ref: '#/components/schemas/TransactionPreconditionsLedgerbounds' min_account_sequence: type: string min_account_sequence_age: type: string min_account_sequence_ledger_gap: type: integer format: uint32 extra_signers: type: array items: type: string Problem: type: object properties: type: type: string description: Identifies the problem type. title: type: string description: A short, human-readable summary of the problem type. status: type: integer description: The HTTP status code for this occurrence of the problem. detail: type: string description: A human-readable explanation specific to this occurrence of the problem. extras: type: object additionalProperties: true description: Additional details that might help the client understand the error(s) that occurred. TransactionListSEP24: type: object properties: records: type: array items: $ref: '#/components/schemas/TransactionSEP24' Effect: type: object properties: _embedded: type: object properties: records: type: array items: type: object properties: _links: type: object properties: operation: $ref: '#/components/schemas/link' succeeds: $ref: '#/components/schemas/link' precedes: $ref: '#/components/schemas/link' id: $ref: '#/components/schemas/id' paging_token: $ref: '#/components/schemas/paging_token' account: $ref: '#/components/schemas/address' type: type: string enum: - Account Created - Account Removed - Account Credited - Account Debited - Account Thresholds Updated - Account Home Domain Updated - Account Flags Updated - Account Inflation Destination Updated - Signer Created - Signer Removed - Signer Updated - Trustline Created - Trustline Removed - Trustline Updated - Trustline Authorized - Trustline Deauthorized - Offer Created - Offer Removed - Offer Updated - Trade - Data Created - Data Removed - Data Updated - Claimable Balance Created - Claimable Balance Claimant Created - Claimable Balance Claimed - Account Sponsorship Created - Account Sponsorship Updated - Account Sponsorship Removed - Trustline Sponsorship Created - Trustline Sponsorship Updated - Trustline Sponsorship Removed - Account Data Sponsorship Created - Account Data Sponsorship Updated - Account Data Sponsorship Removed - Claimable Balance Sponsorship Created - Claimable Balance Sponsorship Updated - Claimable Balance Sponsorship Removed - Account Signer Sponsorship Created - Account Signer Sponsorship Updated - Account Signer Sponsorship Removed - Liquidity Pool Created - Liquidity Pool Removed - Liquidity Pool Revoked - Liquidity Pool Deposited - Liquidity Pool Withdraw - Liquidity Pool Trade - Sequence Bumped type_i: type: number example: 1 created_at: type: string required: - id - paging_token - account - type - type_i - created_at TransactionPreconditionsLedgerbounds: type: object properties: min_ledger: type: string max_ledger: type: string TransactionPreconditionsTimebounds: type: object properties: min_time: type: string max_time: type: string link: type: object properties: href: type: string format: link templated: type: boolean required: - href examples: RetrieveATransactionsOperations: value: _links: self: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a/operations?cursor=&limit=10&order=asc next: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a/operations?cursor=120133379185221636&limit=10&order=asc prev: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a/operations?cursor=120133379185221633&limit=10&order=desc _embedded: records: - _links: self: href: https://horizon-testnet.stellar.org/operations/120133379185221633 transaction: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a effects: href: https://horizon-testnet.stellar.org/operations/120133379185221633/effects succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=120133379185221633 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=120133379185221633 id: '120133379185221633' paging_token: '120133379185221633' transaction_successful: true source_account: GDJX67SFY2N73H72TWMKKBQP5UPBNKBNUMNE2IGFKNES43S4327X6DHG type: manage_buy_offer type_i: 12 created_at: '2020-01-28T21:14:59Z' transaction_hash: 6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a amount: '0.0000000' price: '0.0001000' price_r: n: 1 d: 10000 buying_asset_type: native selling_asset_type: credit_alphanum4 selling_asset_code: ETH selling_asset_issuer: GBDEVU63Y6NTHJQQZIKVTC23NWLQVP3WJ2RI2OTSJTNYOIGICST6DUXR offer_id: 149983118 - _links: self: href: https://horizon-testnet.stellar.org/operations/120133379185221634 transaction: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a effects: href: https://horizon-testnet.stellar.org/operations/120133379185221634/effects succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=120133379185221634 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=120133379185221634 id: '120133379185221634' paging_token: '120133379185221634' transaction_successful: true source_account: GDJX67SFY2N73H72TWMKKBQP5UPBNKBNUMNE2IGFKNES43S4327X6DHG type: manage_buy_offer type_i: 12 created_at: '2020-01-28T21:14:59Z' transaction_hash: 6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a amount: '0.0000000' price: '0.0001000' price_r: n: 1 d: 10000 buying_asset_type: native selling_asset_type: credit_alphanum4 selling_asset_code: ETH selling_asset_issuer: GBDEVU63Y6NTHJQQZIKVTC23NWLQVP3WJ2RI2OTSJTNYOIGICST6DUXR offer_id: 149983119 - _links: self: href: https://horizon-testnet.stellar.org/operations/120133379185221635 transaction: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a effects: href: https://horizon-testnet.stellar.org/operations/120133379185221635/effects succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=120133379185221635 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=120133379185221635 id: '120133379185221635' paging_token: '120133379185221635' transaction_successful: true source_account: GDJX67SFY2N73H72TWMKKBQP5UPBNKBNUMNE2IGFKNES43S4327X6DHG type: manage_offer type_i: 3 created_at: '2020-01-28T21:14:59Z' transaction_hash: 6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a amount: '98.5005752' price: '0.0003494' price_r: n: 17471 d: 50000000 buying_asset_type: credit_alphanum4 buying_asset_code: ETH buying_asset_issuer: GBDEVU63Y6NTHJQQZIKVTC23NWLQVP3WJ2RI2OTSJTNYOIGICST6DUXR selling_asset_type: native offer_id: 0 - _links: self: href: https://horizon-testnet.stellar.org/operations/120133379185221636 transaction: href: https://horizon-testnet.stellar.org/transactions/6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a effects: href: https://horizon-testnet.stellar.org/operations/120133379185221636/effects succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=120133379185221636 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=120133379185221636 id: '120133379185221636' paging_token: '120133379185221636' transaction_successful: true source_account: GDJX67SFY2N73H72TWMKKBQP5UPBNKBNUMNE2IGFKNES43S4327X6DHG type: manage_buy_offer type_i: 12 created_at: '2020-01-28T21:14:59Z' transaction_hash: 6b983a4e0dc3c04f4bd6b9037c55f70a09c434dfd01492be1077cf7ea68c2e4a amount: '291.8057980' price: '0.0002565' price_r: n: 250039 d: 975000000 buying_asset_type: native selling_asset_type: credit_alphanum4 selling_asset_code: ETH selling_asset_issuer: GBDEVU63Y6NTHJQQZIKVTC23NWLQVP3WJ2RI2OTSJTNYOIGICST6DUXR offer_id: 0 SubmitaTransaction: value: memo: Test Transaction memo_bytes: VGVzdCBUcmFuc2FjdGlvbg== _links: self: href: https://horizon-testnet.stellar.org/transactions/8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124 account: href: https://horizon-testnet.stellar.org/accounts/GCIHAQVWZH2AB5BB5NP63FBSIREG77LQZZNUVKD2LN2IOCLOT6N72MJN ledger: href: https://horizon-testnet.stellar.org/ledgers/139575 operations: href: https://horizon-testnet.stellar.org/transactions/8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124/operations{?cursor,limit,order} templated: true effects: href: https://horizon-testnet.stellar.org/transactions/8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124/effects{?cursor,limit,order} templated: true precedes: href: https://horizon-testnet.stellar.org/transactions?order=asc&cursor=599470060347392 succeeds: href: https://horizon-testnet.stellar.org/transactions?order=desc&cursor=599470060347392 transaction: href: https://horizon-testnet.stellar.org/transactions/8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124 id: 8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124 paging_token: '599470060347392' successful: true hash: 8ef0c6d60357bf91b0b0d7800b747ff02bf73117d3e017690cbff641ca67f124 ledger: 139575 created_at: '2021-03-25T21:14:11Z' source_account: GCIHAQVWZH2AB5BB5NP63FBSIREG77LQZZNUVKD2LN2IOCLOT6N72MJN source_account_sequence: '599336916353025' fee_account: GCIHAQVWZH2AB5BB5NP63FBSIREG77LQZZNUVKD2LN2IOCLOT6N72MJN fee_charged: '100' max_fee: '100' operation_count: 1 envelope_xdr: AAAAAgAAAACQcEK2yfQA9CHrX+2UMkRIb/1wzltKqHpbdIcJbp+b/QAAAGQAAiEYAAAAAQAAAAEAAAAAAAAAAAAAAABgXP3QAAAAAQAAABBUZXN0IFRyYW5zYWN0aW9uAAAAAQAAAAAAAAABAAAAAJBwQrbJ9AD0Ietf7ZQyREhv/XDOW0qoelt0hwlun5v9AAAAAAAAAAAF9eEAAAAAAAAAAAFun5v9AAAAQKdJnG8QRiv9xGp1Oq7ACv/xR2BnNqjfUHrGNua7m4tWbrun3+GmAj6ca3xz+4ZppWRTbvTUcCxvpbHERZ85QgY= result_xdr: AAAAAAAAAGQAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAA= result_meta_xdr: AAAAAgAAAAIAAAADAAIhNwAAAAAAAAAAkHBCtsn0APQh61/tlDJESG/9cM5bSqh6W3SHCW6fm/0AAAAXSHbnnAACIRgAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAABAAIhNwAAAAAAAAAAkHBCtsn0APQh61/tlDJESG/9cM5bSqh6W3SHCW6fm/0AAAAXSHbnnAACIRgAAAABAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAA= fee_meta_xdr: AAAAAgAAAAMAAiEYAAAAAAAAAACQcEK2yfQA9CHrX+2UMkRIb/1wzltKqHpbdIcJbp+b/QAAABdIdugAAAIhGAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAEAAiE3AAAAAAAAAACQcEK2yfQA9CHrX+2UMkRIb/1wzltKqHpbdIcJbp+b/QAAABdIduecAAIhGAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA== memo_type: text signatures: - p0mcbxBGK/3EanU6rsAK//FHYGc2qN9QesY25rubi1Zuu6ff4aYCPpxrfHP7hmmlZFNu9NRwLG+lscRFnzlCBg== RetrieveATransaction: value: _links: self: href: https://horizon-testnet.stellar.org/transactions/5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc account: href: https://horizon-testnet.stellar.org/accounts/GDI5EK4HNMBHJJQGP3GUXQJIIOHU2CJO3LABPWD6WYSPJZP5NP67TMNN ledger: href: https://horizon-testnet.stellar.org/ledgers/27963785 operations: href: https://horizon-testnet.stellar.org/transactions/5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc/operations{?cursor,limit,order} templated: true effects: href: https://horizon-testnet.stellar.org/transactions/5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc/effects{?cursor,limit,order} templated: true precedes: href: https://horizon-testnet.stellar.org/transactions?order=asc&cursor=120103542047408128 succeeds: href: https://horizon-testnet.stellar.org/transactions?order=desc&cursor=120103542047408128 id: 5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc paging_token: '120103542047408128' successful: true hash: 5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc ledger: 27963785 created_at: '2020-01-28T10:03:33Z' source_account: GDI5EK4HNMBHJJQGP3GUXQJIIOHU2CJO3LABPWD6WYSPJZP5NP67TMNN source_account_sequence: '65046128646685383' fee_charged: 100 max_fee: 100 operation_count: 1 envelope_xdr: AAAAANHSK4drAnSmBn7NS8EoQ49NCS7awBfYfrYk9OX9a/35AAAAZADnFxwAAALHAAAAAAAAAAAAAAABAAAAAQAAAADR0iuHawJ0pgZ+zUvBKEOPTQku2sAX2H62JPTl/Wv9+QAAAAEAAAAA+qpaPAsU/CGcSeS4KnvqE9y+Bcjhyr1l6jiwixRsvu8AAAABTkdOVAAAAAAs4YIuYne69wMuNtfiZ64gb7E3qnTR7A4yD4jZDSS8AQAAAdGpSiAAAAAAAAAAAAH9a/35AAAAQM5LSBiFRQKtFYRPpNabwVuvIhZSVRDaajf0KzYaqJmgaXAlFaTOYyYc11YuxUM1Fzl1VT4UEbI22BvO/8HzUgQ= result_xdr: AAAAAAAAAGQAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAA= result_meta_xdr: AAAAAQAAAAIAAAADAaqxiQAAAAAAAAAA0dIrh2sCdKYGfs1LwShDj00JLtrAF9h+tiT05f1r/fkAAAAAAhWQlADnFxwAAALGAAAAAQAAAAEAAAAAhD8BLsZFQEF33rKS6YopQUT3b6iLBG4nspe68/DBNBYAAAAAAAAAAAEAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBqrGJAAAAAAAAAADR0iuHawJ0pgZ+zUvBKEOPTQku2sAX2H62JPTl/Wv9+QAAAAACFZCUAOcXHAAAAscAAAABAAAAAQAAAACEPwEuxkVAQXfespLpiilBRPdvqIsEbieyl7rz8ME0FgAAAAAAAAAAAQAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAQAAAADAan62gAAAAEAAAAA+qpaPAsU/CGcSeS4KnvqE9y+Bcjhyr1l6jiwixRsvu8AAAABTkdOVAAAAAAs4YIuYne69wMuNtfiZ64gb7E3qnTR7A4yD4jZDSS8AQAAAAAAAAALf/////////8AAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBqrGJAAAAAQAAAAD6qlo8CxT8IZxJ5Lgqe+oT3L4FyOHKvWXqOLCLFGy+7wAAAAFOR05UAAAAACzhgi5id7r3Ay421+JnriBvsTeqdNHsDjIPiNkNJLwBAAAB0alKIAt//////////wAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwGp+6EAAAABAAAAANHSK4drAnSmBn7NS8EoQ49NCS7awBfYfrYk9OX9a/35AAAAAU5HTlQAAAAALOGCLmJ3uvcDLjbX4meuIG+xN6p00ewOMg+I2Q0kvAEAAAkQQwRXzX//////////AAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAaqxiQAAAAEAAAAA0dIrh2sCdKYGfs1LwShDj00JLtrAF9h+tiT05f1r/fkAAAABTkdOVAAAAAAs4YIuYne69wMuNtfiZ64gb7E3qnTR7A4yD4jZDSS8AQAABz6ZujfNf/////////8AAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA== fee_meta_xdr: AAAAAgAAAAMBqfuhAAAAAAAAAADR0iuHawJ0pgZ+zUvBKEOPTQku2sAX2H62JPTl/Wv9+QAAAAACFZD4AOcXHAAAAsYAAAABAAAAAQAAAACEPwEuxkVAQXfespLpiilBRPdvqIsEbieyl7rz8ME0FgAAAAAAAAAAAQAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQGqsYkAAAAAAAAAANHSK4drAnSmBn7NS8EoQ49NCS7awBfYfrYk9OX9a/35AAAAAAIVkJQA5xccAAACxgAAAAEAAAABAAAAAIQ/AS7GRUBBd96ykumKKUFE92+oiwRuJ7KXuvPwwTQWAAAAAAAAAAABAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA= memo_type: none signatures: - zktIGIVFAq0VhE+k1pvBW68iFlJVENpqN/QrNhqomaBpcCUVpM5jJhzXVi7FQzUXOXVVPhQRsjbYG87/wfNSBA== RetrieveATransactionsEffects: value: _links: self: href: https://horizon-testnet.stellar.org/transactions/512a9946bc7ff4a363299f14f79e0beb9b9cdbd0103e3a69a44446a0aa6471a8/effects?cursor=&limit=10&order=asc next: href: https://horizon-testnet.stellar.org/transactions/512a9946bc7ff4a363299f14f79e0beb9b9cdbd0103e3a69a44446a0aa6471a8/effects?cursor=121628667754319873-2&limit=10&order=asc prev: href: https://horizon-testnet.stellar.org/transactions/512a9946bc7ff4a363299f14f79e0beb9b9cdbd0103e3a69a44446a0aa6471a8/effects?cursor=121628667754319873-1&limit=10&order=desc _embedded: records: - _links: operation: href: https://horizon-testnet.stellar.org/operations/121628667754319873 succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=121628667754319873-1 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=121628667754319873-1 id: 0121628667754319873-0000000001 paging_token: 121628667754319873-1 account: GAHK7EEG2WWHVKDNT4CEQFZGKF2LGDSW2IVM4S5DP42RBW3K6BTODB4A type: account_credited type_i: 2 created_at: '2020-02-20T21:18:33Z' asset_type: native amount: '1573.5112616' - _links: operation: href: https://horizon-testnet.stellar.org/operations/121628667754319873 succeeds: href: https://horizon-testnet.stellar.org/effects?order=desc&cursor=121628667754319873-2 precedes: href: https://horizon-testnet.stellar.org/effects?order=asc&cursor=121628667754319873-2 id: 0121628667754319873-0000000002 paging_token: 121628667754319873-2 account: GA2XP4KMY4KWNPW4KUCUKYUF2J7Y6HO5HLPUEA3VPVSMYCM3TGNEZP5S type: account_debited type_i: 3 created_at: '2020-02-20T21:18:33Z' asset_type: native amount: '1573.5112616' parameters: OrderParam: name: order in: query required: false description: A designation of the order in which records should appear. Options include `asc` (ascending) or `desc` (descending). If this argument isn’t set, it defaults to `asc`. schema: type: string enum: - asc - desc JoinParam: name: join in: query required: false description: Set to transactions to include the transactions which created each of the operations in the response. CursorParam: name: cursor in: query required: false description: A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record. schema: type: integer example: 6606617478959105 HashParam: name: transaction_hash in: path required: true description: Transactions are commands that modify the ledger state and consist of one or more operations. schema: type: string example: 5ebd5c0af4385500b53dd63b0ef5f6e8feef1a7e1c86989be3cdcce825f3c0cc LimitParam: name: limit in: query required: false description: The maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10. schema: type: integer example: 10 IncludeFailedParam: name: include_failed in: query required: false description: Set to true to include failed operations in results. Options include true and false. schema: type: boolean enum: - true - false