eBay · Capability
eBay Finances API — Transaction
eBay Finances API — Transaction. 2 operations. Lead operation: Transaction. Self-contained Naftiko capability covering one Ebay business surface.
What You Can Do
GET
Gettransactions
—
/v1/transaction
GET
Gettransactionsummary
—
/v1/transaction-summary
MCP Tools
div-class-msgbox-important-p-class-msgbox-importantindiv
read-only
idempotent
div-class-msgbox-important-p-class-msgbox-importantindiv-2
read-only
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: eBay Finances API — Transaction
description: 'eBay Finances API — Transaction. 2 operations. Lead operation: Transaction. Self-contained Naftiko capability
covering one Ebay business surface.'
tags:
- Ebay
- Transaction
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
EBAY_API_KEY: EBAY_API_KEY
capability:
consumes:
- type: http
namespace: finances-transaction
baseUri: https://apiz.ebay.com{basePath}
description: eBay Finances API — Transaction business capability. Self-contained, no shared references.
resources:
- name: transaction
path: /transaction
operations:
- name: gettransactions
method: GET
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the seller's eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
" target="_blank ">HTTP request
required: true
- name: filter
in: query
type: string
description: 'Numerous filters are available for the <strong>getTransactions</strong> method, and these filters
are discussed below. One or more of these filter types can be '
- name: limit
in: query
type: string
description: The number of monetary transactions to return per page of the result set. Use this parameter in conjunction
with the <b>offset</b> parameter to control the pagi
- name: offset
in: query
type: string
description: This integer value indicates the actual position that the first monetary transaction returned on the
current page has in the results set. So, if you wanted to v
- name: sort
in: query
type: string
description: 'By default, monetary transactions that match the input criteria are sorted in descending order according
to the transaction date (i.e, most recent transactions '
- name: transaction_summary
path: /transaction_summary
operations:
- name: gettransactionsummary
method: GET
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the seller's eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
" target="_blank ">HTTP request
required: true
- name: filter
in: query
type: string
description: Numerous filters are available for the <strong>getTransactionSummary</strong> method, and these filters
are discussed below. One or more of these filter types c
authentication:
type: bearer
token: '{{env.EBAY_API_KEY}}'
exposes:
- type: rest
namespace: finances-transaction-rest
port: 8080
description: REST adapter for eBay Finances API — Transaction. One Spectral-compliant resource per consumed operation,
prefixed with /v1.
resources:
- path: /v1/transaction
name: transaction
description: REST surface for transaction.
operations:
- method: GET
name: gettransactions
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
call: finances-transaction.gettransactions
with:
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
filter: rest.filter
limit: rest.limit
offset: rest.offset
sort: rest.sort
outputParameters:
- type: object
mapping: $.
- path: /v1/transaction-summary
name: transaction-summary
description: REST surface for transaction_summary.
operations:
- method: GET
name: gettransactionsummary
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
call: finances-transaction.gettransactionsummary
with:
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
filter: rest.filter
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: finances-transaction-mcp
port: 9090
transport: http
description: MCP adapter for eBay Finances API — Transaction. One tool per consumed operation, routed inline through this
capability's consumes block.
tools:
- name: div-class-msgbox-important-p-class-msgbox-importantindiv
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
hints:
readOnly: true
destructive: false
idempotent: true
call: finances-transaction.gettransactions
with:
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
filter: tools.filter
limit: tools.limit
offset: tools.offset
sort: tools.sort
outputParameters:
- type: object
mapping: $.
- name: div-class-msgbox-important-p-class-msgbox-importantindiv-2
description: '<div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color:
#dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><sp'
hints:
readOnly: true
destructive: false
idempotent: true
call: finances-transaction.gettransactionsummary
with:
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
filter: tools.filter
outputParameters:
- type: object
mapping: $.