> For a complete index of Agora Finance documentation, fetch https://docs.agora.finance/llms.txt # List Transactions GET https://api.agora.finance/v0/transactions List your settled transactions, newest first, with cursor pagination. Each entry summarizes the `source` and `recipient`, the per-currency totals each side moved, and the `type` (`mint`, `redeem`, `bridge`, `reward`, `return`). `type` and `status` are open enums; tolerate unknown values. Fetch one transaction's legs with [Get a Transaction by ID](/api/endpoints/transactions/getbyid). Narrow the list with `type`, `sourceChain`, `recipientChain`, `isInstantSettlement`, and an `initiatedAt` range; every filter you send must hold (see [Filtering list endpoints](/api#filtering-list-endpoints)). The chain filters match the `source` and `recipient` the response reports, so a mint funded by wire matches on `recipientChain` only. Reference: https://docs.agora.finance/api/endpoints/transactions/list ## Authentication - `Authorization` header (bearer token, required) — Session JWT from `POST /v0/auth/token`, sent as `Authorization: Bearer `. See [Authentication](/api/authentication) for more details. ## Request ### Query parameters - `cursor` (string, optional) — Opaque pagination cursor. Pass the `nextCursor` from the previous response; omit to fetch the first page. - `limit` (integer, optional, default: 50) — Page size. Defaults to 50; capped at 200. - `initiatedAt.gt` (datetime, optional) — Exclusive lower bound on the transaction's initiation time, as an ISO-8601 timestamp. - `initiatedAt.gte` (datetime, optional) — Inclusive lower bound on the transaction's initiation time, as an ISO-8601 timestamp. - `initiatedAt.lt` (datetime, optional) — Exclusive upper bound on the transaction's initiation time, as an ISO-8601 timestamp. Pairs with `initiatedAt.gte` to select a period without depending on its last instant. - `initiatedAt.lte` (datetime, optional) — Inclusive upper bound on the transaction's initiation time, as an ISO-8601 timestamp. - `isInstantSettlement` (enum, optional) — Return only transactions whose settlement path matches. `true` is the instant-settlement path; `false` is standard settlement, which includes movement types that have no settlement path of their own, such as rewards and returns. - Allowed values: `true`, `false` - `recipientChain` (list of enum, optional) — Return only transactions whose recipient received value on these networks, comma-separated. - Allowed values: `arbitrum`, `avalanche`, `base`, `ethereum`, `immutable`, `monad`, `polygon-pos`, `solana` - `sourceChain` (list of enum, optional) — Return only transactions whose source sent value on these networks, comma-separated. - Allowed values: `arbitrum`, `avalanche`, `base`, `ethereum`, `immutable`, `monad`, `polygon-pos`, `solana` - `type` (list of enum, optional) — Return only these movement types, comma-separated. - Allowed values: `bridge`, `mint`, `redeem`, `return`, `reward` ## Response ### 200 OK - `data` (list of V0TransactionsGetResponsesContentApplicationJsonSchemaDataItems, required) — Page of transactions, newest first (by initiated time, tie-broken by id). - `nextCursor` (string, required, nullable) — Opaque cursor for the next page. Pass back verbatim as the `cursor` query param; null when no more results. ## Errors ### 400 Bad Request Error One or more request parameters are invalid. - `code` (enum, required) - Allowed values: `parameter_invalid` - `docs_url` (string, required) - `message` (string, required) - `context` (ErrorResponse400ParameterInvalidContext, optional) ### 401 Unauthorized Error Authentication is required. - `code` (enum, required) - Allowed values: `unauthorized` - `docs_url` (string, required) - `message` (string, required) - `context` (ErrorResponse401UnauthorizedContext, optional) ### 403 Forbidden Error The account is not eligible for the requested route direction. - `code` (enum, required) - Allowed values: `account_not_eligible`, `account_not_provisioned`, `account_verification_pending`, `forbidden` - `docs_url` (string, required) - `message` (string, required) ### 404 Not Found Error Resource not found. - `code` (enum, required) - Allowed values: `not_found` - `docs_url` (string, required) - `message` (string, required) ### 429 Too Many Requests Error Too many requests. - `code` (enum, required) - Allowed values: `rate_limit_exceeded` - `docs_url` (string, required) - `message` (string, required) ### 500 Internal Server Error An unexpected error occurred. - `code` (enum, required) - Allowed values: `internal_error` - `docs_url` (string, required) - `message` (string, required) ## Types ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItems Settled-transaction summary. Fetch the detail endpoint with `id` for per-leg detail. - `id` (string, required) — Stable UUID identifying this transaction; pass to the detail endpoint to fetch legs. - `initiatedAt` (datetime, required) — ISO-8601 timestamp of the first leg. - `isInstantSettlement` (boolean, required) — True if this transaction used Agora's instant-settlement path rather than standard settlement. - `legCount` (integer, required) — Number of customer-facing legs in this transaction. - `recipient` (V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipient, required) — The counterparty receiving value, with the totals it received. - `settledAt` (datetime, required, nullable) — ISO-8601 timestamp when the transaction settled. Null until settled. - `source` (V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSource, required) — The counterparty sending value, with the totals it sent. - `status` (string, required) — Lifecycle status. v1 emits only `"settled"`. This is an open, extensible enum; future values (e.g. `pending`) may appear, so clients must tolerate unknown values. - `type` (string, required) — Customer-facing transaction type: `mint`, `redeem`, `bridge`, `reward`, or `return`. Treated as an open enum; tolerate unknown values. ### ErrorResponse400ParameterInvalidContext - `issues` (list of ErrorResponse400ParameterInvalidContextIssuesItems, required) ### ErrorResponse401UnauthorizedContext - `reason` (enum, required) - Allowed values: `invalid_token`, `key_not_provisioned`, `missing_claim`, `missing_header`, `token_expired`, `token_paused`, `token_revoked`, `unknown_tenant` ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipient The counterparty receiving value, with the totals it received. ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSource The counterparty sending value, with the totals it sent. ### ErrorResponse400ParameterInvalidContextIssuesItems - `field` (string, required) - `message` (string, required) ### Bank Account - `kind` (enum, required) — Discriminator: the counterparty is a bank account. - Allowed values: `bank` - `accountId` (string, required, nullable) — UUID of the customer account this counterparty maps to (same id as `/v0/accounts`), or null when the address is not a known account (e.g. the Agora side). Bank counterparties currently always return null; bank-to-account linkage is not derived yet. - `accountNumber` (string, required, nullable) — Bank account number. Null when unknown. - `bankName` (string, required, nullable) — Name of the financial institution, when known. - `name` (string, required, nullable) — Display label for the counterparty. The Agora side of a leg is labelled `"Agora"`. - `amounts` (list of V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipientOneOf0AmountsItems, required) — Per-currency totals moved on this side of the transaction, one entry per currency. ### Wallet - `kind` (enum, required) — Discriminator: the counterparty is a blockchain address. - Allowed values: `wallet` - `accountId` (string, required, nullable) — UUID of the customer account this counterparty maps to (same id as `/v0/accounts`), or null when the address is not a known account (e.g. the Agora side). Bank counterparties currently always return null; bank-to-account linkage is not derived yet. - `address` (string, required, nullable) — On-chain address, EIP-55 checksummed for EVM. Public on-chain data, returned in full. Null when unknown. - `chain` (string, required) — Chain the address is on, as the public-API network id (e.g. `ethereum`, `base`). Non-public/historical chains fall back to the raw chain id. Treated as an open enum; tolerate unknown values. - `name` (string, required, nullable) — Display label for the counterparty. The Agora side of a leg is labelled `"Agora"`. - `amounts` (list of V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipientOneOf1AmountsItems, required) — Per-currency totals moved on this side of the transaction, one entry per currency. ### Bank Account - `kind` (enum, required) — Discriminator: the counterparty is a bank account. - Allowed values: `bank` - `accountId` (string, required, nullable) — UUID of the customer account this counterparty maps to (same id as `/v0/accounts`), or null when the address is not a known account (e.g. the Agora side). Bank counterparties currently always return null; bank-to-account linkage is not derived yet. - `accountNumber` (string, required, nullable) — Bank account number. Null when unknown. - `bankName` (string, required, nullable) — Name of the financial institution, when known. - `name` (string, required, nullable) — Display label for the counterparty. The Agora side of a leg is labelled `"Agora"`. - `amounts` (list of V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSourceOneOf0AmountsItems, required) — Per-currency totals moved on this side of the transaction, one entry per currency. ### Wallet - `kind` (enum, required) — Discriminator: the counterparty is a blockchain address. - Allowed values: `wallet` - `accountId` (string, required, nullable) — UUID of the customer account this counterparty maps to (same id as `/v0/accounts`), or null when the address is not a known account (e.g. the Agora side). Bank counterparties currently always return null; bank-to-account linkage is not derived yet. - `address` (string, required, nullable) — On-chain address, EIP-55 checksummed for EVM. Public on-chain data, returned in full. Null when unknown. - `chain` (string, required) — Chain the address is on, as the public-API network id (e.g. `ethereum`, `base`). Non-public/historical chains fall back to the raw chain id. Treated as an open enum; tolerate unknown values. - `name` (string, required, nullable) — Display label for the counterparty. The Agora side of a leg is labelled `"Agora"`. - `amounts` (list of V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSourceOneOf1AmountsItems, required) — Per-currency totals moved on this side of the transaction, one entry per currency. ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipientOneOf0AmountsItems A per-currency amount moved on one side of the transaction. - `amount` (string, required) — Decimal amount as a string (avoids floating-point precision loss). - `currency` (string, required) — Currency code, e.g. `usd`, `ausd`, `usdc`. ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsRecipientOneOf1AmountsItems A per-currency amount moved on one side of the transaction. - `amount` (string, required) — Decimal amount as a string (avoids floating-point precision loss). - `currency` (string, required) — Currency code, e.g. `usd`, `ausd`, `usdc`. ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSourceOneOf0AmountsItems A per-currency amount moved on one side of the transaction. - `amount` (string, required) — Decimal amount as a string (avoids floating-point precision loss). - `currency` (string, required) — Currency code, e.g. `usd`, `ausd`, `usdc`. ### V0TransactionsGetResponsesContentApplicationJsonSchemaDataItemsSourceOneOf1AmountsItems A per-currency amount moved on one side of the transaction. - `amount` (string, required) — Decimal amount as a string (avoids floating-point precision loss). - `currency` (string, required) — Currency code, e.g. `usd`, `ausd`, `usdc`. ## Examples ### All transactions **Response** ```json { "data": [ { "id": "1f0a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c", "initiatedAt": "2026-06-21T14:02:00Z", "isInstantSettlement": false, "legCount": 2, "recipient": { "accountId": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c", "address": "0xF5e6D7c8B9A0F5e6D7c8B9A0F5e6D7c8B9A0F5e6", "amounts": [ { "amount": "250000.000000", "currency": "ausd" } ], "chain": "ethereum", "kind": "wallet", "name": "ETH treasury" }, "settledAt": "2026-06-21T14:46:00Z", "source": { "accountId": null, "accountNumber": "987654321234", "amounts": [ { "amount": "250000.000000", "currency": "usd" } ], "bankName": "JPMorgan Chase", "kind": "bank", "name": "Acme Corp" }, "status": "settled", "type": "mint" }, { "id": "2a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d", "initiatedAt": "2026-06-20T09:12:00Z", "isInstantSettlement": true, "legCount": 2, "recipient": { "accountId": null, "accountNumber": "987654321234", "amounts": [ { "amount": "50000.000000", "currency": "usd" } ], "bankName": "JPMorgan Chase", "kind": "bank", "name": "Acme Corp" }, "settledAt": "2026-06-20T09:13:00Z", "source": { "accountId": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c", "address": "0xF5e6D7c8B9A0F5e6D7c8B9A0F5e6D7c8B9A0F5e6", "amounts": [ { "amount": "50000.000000", "currency": "ausd" } ], "chain": "ethereum", "kind": "wallet", "name": "ETH treasury" }, "status": "settled", "type": "redeem" } ], "nextCursor": "eyJpbml0aWF0ZWRBdCI6IjIwMjYtMDYtMjAifQ" } ``` **SDK Code** ```python All transactions import requests url = "https://api.agora.finance/v0/transactions" querystring = {"limit":"50"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript All transactions const url = 'https://api.agora.finance/v0/transactions?limit=50'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go All transactions package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.agora.finance/v0/transactions?limit=50" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby All transactions require 'uri' require 'net/http' url = URI("https://api.agora.finance/v0/transactions?limit=50") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java All transactions import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.agora.finance/v0/transactions?limit=50") .header("Authorization", "Bearer ") .asString(); ``` ```php All transactions request('GET', 'https://api.agora.finance/v0/transactions?limit=50', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp All transactions using RestSharp; var client = new RestClient("https://api.agora.finance/v0/transactions?limit=50"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift All transactions import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.agora.finance/v0/transactions?limit=50")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Filtered **Response** ```json { "data": [ { "id": "2a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d", "initiatedAt": "2026-06-20T09:12:00Z", "isInstantSettlement": true, "legCount": 2, "recipient": { "accountId": null, "accountNumber": "987654321234", "amounts": [ { "amount": "50000.000000", "currency": "usd" } ], "bankName": "JPMorgan Chase", "kind": "bank", "name": "Acme Corp" }, "settledAt": "2026-06-20T09:13:00Z", "source": { "accountId": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c", "address": "0xF5e6D7c8B9A0F5e6D7c8B9A0F5e6D7c8B9A0F5e6", "amounts": [ { "amount": "50000.000000", "currency": "ausd" } ], "chain": "ethereum", "kind": "wallet", "name": "ETH treasury" }, "status": "settled", "type": "redeem" } ], "nextCursor": null } ``` **SDK Code** ```python Filtered import requests url = "https://api.agora.finance/v0/transactions" querystring = {"initiatedAt.gte":"2026-06-01T00:00:00Z","initiatedAt.lt":"2026-07-01T00:00:00Z","isInstantSettlement":"true","sourceChain":"ethereum","type":"redeem"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Filtered const url = 'https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Filtered package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Filtered require 'uri' require 'net/http' url = URI("https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Filtered import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem") .header("Authorization", "Bearer ") .asString(); ``` ```php Filtered request('GET', 'https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Filtered using RestSharp; var client = new RestClient("https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Filtered import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.agora.finance/v0/transactions?initiatedAt.gte=2026-06-01T00%3A00%3A00Z&initiatedAt.lt=2026-07-01T00%3A00%3A00Z&isInstantSettlement=true&sourceChain=ethereum&type=redeem")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```