Nestcoin

Nestcoin Transactions Transactions API

The transactions-transactions API from Nestcoin — 4 operation(s) for transactions-transactions.

GitHub OpenAPI

Operations 4

GET /transactions/{id} Retrieve a particular transaction #
GET /transactions/{id}/contacts Retrieve a particular transaction's contacts. Currently just phone numbers #
GET /transactions/customers/{id}/history Retrieve list of customer transactions #
GET /transactions/customers/{id}/history-aggregate Retrieve list of customer transactions #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nestcoin/refs/heads/main/openapi/nestcoin-transactions-transactions-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/nestcoin/refs/heads/main/asyncapi/nestcoin-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/nestcoin/refs/heads/main/errors/nestcoin-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/nestcoin/refs/heads/main/data-model/nestcoin-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nestcoin-transactions-transactions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nestcoin-transactions-transactions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 3.0.2
  title: Onboard External API Gateway Transactions Transactions API
  description: '**Introduction**

    API Gateway for Onboard


    This specification describes API endpoints that are available to the public internet via the API gateway.'
  contact:
    name: Nestcoin TechOps
    email: techops@nestcoin.com
  license:
    name: UNLICENSED
servers:
- url: https://external.dev.onboardpay.co
  description: Gateway for external API on staging environment.
tags:
- name: transactions-transactions
paths:
  /transactions/{id}:
    x-original-path: /transactions/{id}
    get:
      tags:
      - transactions-transactions
      summary: Retrieve a particular transaction
      operationId: getTransactionById
      parameters:
      - $ref: '#/components/parameters/TransactionsSvcidPathVariable'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDTO'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '401':
          description: Unauthorized request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
      security:
      - authToken: []
      x-visibility: external
  /transactions/{id}/contacts:
    x-original-path: /transactions/{id}/contacts
    get:
      tags:
      - transactions-transactions
      summary: Retrieve a particular transaction's contacts. Currently just phone numbers
      operationId: getTransactionContacts
      parameters:
      - $ref: '#/components/parameters/TransactionsSvcidPathVariable'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionContactsDTO'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '401':
          description: Unauthorized request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
      security:
      - authToken: []
      x-visibility: external
  /transactions/customers/{id}/history:
    x-original-path: /transactions/customers/{id}/history
    get:
      tags:
      - transactions-transactions
      summary: Retrieve list of customer transactions
      operationId: getCustomerTransactions
      parameters:
      - $ref: '#/components/parameters/TransactionsSvcidPathVariableForUserId'
      - $ref: '#/components/parameters/TransactionsSvctransactionTypeParam'
      - $ref: '#/components/parameters/TransactionsSvcfromDateParam'
      - $ref: '#/components/parameters/TransactionsSvctoDateParam'
      - $ref: '#/components/parameters/TransactionsSvcsizeParam'
      - $ref: '#/components/parameters/TransactionsSvcpageParam'
      - $ref: '#/components/parameters/TransactionsSvcstatusesParam'
      - $ref: '#/components/parameters/TransactionsSvctokenQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcfiatQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcnetworkQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcpaymentChannelQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcreferenceQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcotherPartyQueryParam'
      - name: tradeRequestBroadcastId
        in: query
        schema:
          type: string
      - $ref: '#/components/parameters/TransactionsSvcisTradeRequestBroadcastQueryParam'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionsResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '401':
          description: Unauthorized request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
      security:
      - authToken: []
      x-visibility: external
  /transactions/customers/{id}/history-aggregate:
    x-original-path: /transactions/customers/{id}/history-aggregate
    get:
      tags:
      - transactions-transactions
      summary: Retrieve list of customer transactions
      operationId: getCustomerTransactionsAggregate
      parameters:
      - $ref: '#/components/parameters/TransactionsSvcidPathVariableForUserId'
      - $ref: '#/components/parameters/TransactionsSvctransactionTypeParam'
      - $ref: '#/components/parameters/TransactionsSvcfromDateParam'
      - $ref: '#/components/parameters/TransactionsSvctoDateParam'
      - $ref: '#/components/parameters/TransactionsSvcstatusesParam'
      - $ref: '#/components/parameters/TransactionsSvctokenQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcfiatQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcnetworkQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcpaymentChannelQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcreferenceQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcotherPartyQueryParam'
      - $ref: '#/components/parameters/TransactionsSvcisTradeRequestBroadcastQueryParam'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionHistoryAggregate'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '401':
          description: Unauthorized request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessageDto'
      security:
      - authToken: []
      x-visibility: external
components:
  parameters:
    TransactionsSvcpageParam:
      name: page
      in: query
      schema:
        type: integer
    TransactionsSvcsizeParam:
      name: size
      in: query
      schema:
        type: integer
    TransactionsSvctokenQueryParam:
      name: token
      in: query
      schema:
        type: string
    TransactionsSvcidPathVariableForUserId:
      name: id
      in: path
      description: userId
      required: true
      schema:
        type: string
        format: uuid
    TransactionsSvcfromDateParam:
      name: from
      in: query
      description: 15-04-2022
      schema:
        type: string
        pattern: \d{2}-\d{2}-\d{4}
    TransactionsSvcstatusesParam:
      name: statuses
      in: query
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/TransactionOrderStatus'
    TransactionsSvcotherPartyQueryParam:
      name: otherPartyId
      in: query
      schema:
        type: string
        format: uuid
    TransactionsSvcisTradeRequestBroadcastQueryParam:
      name: isTradeRequestBroadcast
      in: query
      schema:
        type: boolean
    TransactionsSvcnetworkQueryParam:
      name: network
      in: query
      schema:
        type: string
    TransactionsSvctoDateParam:
      name: to
      in: query
      description: 15-08-2022
      schema:
        type: string
        pattern: \d{2}-\d{2}-\d{4}
    TransactionsSvcpaymentChannelQueryParam:
      name: paymentChannel
      in: query
      schema:
        type: string
    TransactionsSvcreferenceQueryParam:
      name: reference
      in: query
      schema:
        type: string
    TransactionsSvcfiatQueryParam:
      name: fiat
      in: query
      schema:
        type: string
    TransactionsSvctransactionTypeParam:
      name: transactionType
      in: query
      schema:
        $ref: '#/components/schemas/TransactionsSvcTransactionType'
    TransactionsSvcidPathVariable:
      name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    TransactionOrderStatus:
      type: string
      description: Order transaction status
      enum:
      - INITIATED
      - DEPOSITED
      - CONFIRMED
      - COMPLETED
      - PENDING
      - CANCELLED
      - IN_DISPUTE
      - AWAITING_ACCEPTANCE
      x-source-svc: transactions
    TradeContext:
      type: string
      enum:
      - STANDARD_TRADE
      - INTERNAL_RAIL
      x-source-svc: transactions
    TransactionsSvcTradeMode:
      type: string
      enum:
      - P2P
      - IP
      - OTC
      x-source-svc: transactions
    UserType:
      type: string
      description: Type of user/role of user in transaction
      enum:
      - CUSTOMER
      - PARTNER
      x-source-svc: transactions
    TimeoutDTO:
      type: object
      properties:
        name:
          type: string
          enum:
          - APPROVE_TRANSACTION
          - MAKE_DEPOSIT
          - CONFIRM_DEPOSIT
          - FLAG_DISPUTE
          - ACKNOWLEDGE_TRANSACTION
        startTime:
          type: string
          format: date-time
          x-faker: date.recent
        duration:
          type: number
        timeLeft:
          type: integer
          format: int64
      x-source-svc: transactions
    TransactionsSvcTransactionType:
      type: string
      description: Transaction order type, can be ONRAMP or OFFRAMP
      enum:
      - ONRAMP
      - OFFRAMP
      x-source-svc: transactions
    Fee:
      required:
      - asFiat
      - asToken
      type: object
      properties:
        asToken:
          type: string
          pattern: ([0-9]*[.])?[0-9]+
          example: '1000.0'
        asFiat:
          type: number
      x-source-svc: transactions
    TransactionsResponse:
      type: object
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDTO'
        pageNumber:
          type: integer
        pageSize:
          type: integer
        totalPages:
          type: integer
        totalTransactions:
          type: integer
      x-source-svc: transactions
    TransactionsSvcWalletDTO:
      type: object
      properties:
        walletAddress:
          type: string
          example: 0
        networkId:
          type: string
          example: bsc_testnet
        walletName:
          type: string
          example: My Trust Wallet
      x-source-svc: transactions
    TransactionHistoryAggregate:
      type: object
      required:
      - tradeCount
      - tradeUsdTotal
      properties:
        userId:
          type: string
          format: uuid
        tradeCount:
          type: integer
        tradeUsdTotal:
          type: number
          example: 3849594.1
        fiatTotal:
          type: number
          example: 1245.92
        tokenTotal:
          type: number
          example: 245.73
      x-source-svc: transactions
    TransactionContactsDTO:
      type: object
      properties:
        customerPhoneNumber:
          type: string
          example: '23408100000000'
        merchantPhoneNumber:
          type: string
          example: '23408100000001'
      x-source-svc: transactions
    ThirdpartyOrderInfoDTO:
      required:
      - businessId
      properties:
        businessId:
          type: string
          description: The thirdparty business the customer is trading via
        tradeId:
          type: string
          description: Tracking trade Id
        product:
          type: string
          description: Product name, typically custodial or web
        blockchainOrderId:
          type: integer
        externalOrderReference:
          type: string
      x-source-svc: transactions
    ErrorMessageDto:
      description: Default error object for services. This gives consistent error object that all services may use.
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: string
          description: Error code
          example: UNKNOWN_ERROR
        message:
          type: string
          description: Descriptive error message
          example: Request could not be completed due to an error
        data:
          type: object
          description: Additional data for this error message.
          additionalProperties: true
          properties: {}
      x-common-model: ErrorMessageDto
    TransactionDTO:
      required:
      - customerId
      - fee
      - id
      - reference
      - status
      type: object
      properties:
        id:
          type: string
          format: uuid
        reference:
          type: string
          example: 0165359005113074501885
        customerId:
          type: string
          format: uuid
        customerName:
          type: string
          example: John Doe
        offer:
          $ref: '#/components/schemas/TransactionsSvcOfferDTO'
        escrowAddress:
          type: string
          description: Escrow address
          example: 1.2869144918162796e+48
        paymentChannelId:
          type: string
          example: BANK_TRANSFER_NIGERIA
        paymentMethod:
          type: object
          properties: {}
        buyerPaymentMethod:
          type: object
          properties: {}
        customerWallet:
          $ref: '#/components/schemas/TransactionsSvcWalletDTO'
        tokenAddress:
          type: string
          example: 0
        status:
          $ref: '#/components/schemas/TransactionOrderStatus'
        createdAt:
          type: string
          format: date-time
          x-faker: date.recent
        initiatedAt:
          type: string
          format: date-time
          x-faker: date.recent
        depositedAt:
          type: string
          format: date-time
          x-faker: date.recent
        confirmedAt:
          type: string
          format: date-time
          x-faker: date.recent
        completedAt:
          type: string
          format: date-time
          x-faker: date.recent
        cancelledAt:
          type: string
          format: date-time
          x-faker: date.recent
        cancellationReason:
          type: string
        disputeId:
          type: string
          default: 'null'
        timeout:
          $ref: '#/components/schemas/TimeoutDTO'
        lockHash:
          type: string
          default: 'null'
        confirmationHash:
          type: string
          default: 'null'
        cancellationHash:
          type: string
          default: 'null'
        isPartnerAcknowledged:
          type: boolean
          default: false
        defaultingParty:
          $ref: '#/components/schemas/UserType'
        rating:
          type: number
          example: 3
        isCexOrder:
          type: boolean
          example: false
        fee:
          $ref: '#/components/schemas/Fee'
        instantPayProcessingStatus:
          $ref: '#/components/schemas/InstantPayProcessingStatus'
        tradeValue:
          type: number
          description: Actual token amount that is to be traded
          deprecated: true
        merchantTokenValue:
          type: number
          description: Actual token value that is to be traded by merchant less any fees
        customerTokenValue:
          type: number
          description: Actual token value that is to be traded by customer less any fees
        payableAmount:
          type: number
          description: Actual fiat amount that is to be paid.
        thirdpartyOrderInfo:
          $ref: '#/components/schemas/ThirdpartyOrderInfoDTO'
        isNoKyc:
          type: boolean
          description: Flag showing if order is a no kyc order
        paymentReceiptUploadId:
          type: string
          description: Upload ID for receipt uploaded on storage bucket
          default: 'null'
        suppressCustomerNotifications:
          type: boolean
          description: Flag to indicate if notifications should be sent to the customer or not during the lifetime of this transaction
          default: false
        chatUnavailable:
          type: boolean
          description: Flag to indicate if chat is unavailable for this transaction
          default: false
        tradeContext:
          $ref: '#/components/schemas/TradeContext'
      x-source-svc: transactions
    TransactionsSvcOfferDTO:
      required:
      - instantPayEnabled
      - networkId
      - partnerId
      - rate
      - token
      - tokenAmount
      - transactionType
      type: object
      properties:
        offerId:
          type: string
          format: uuid
        partnerId:
          type: string
          format: uuid
        transactionType:
          $ref: '#/components/schemas/TransactionsSvcTransactionType'
        rate:
          type: number
          example: 0.32
        networkId:
          type: string
          example: TRC20
        fiatSymbol:
          type: string
          example: NGN
        fiatAmount:
          type: number
          example: 120.5
        token:
          type: string
          example: USDT
        tokenAmount:
          type: number
          example: 120.5
        usdAmount:
          type: number
          example: 120.5
        partnerDisplayName:
          type: string
          example: John Doe
        adNote:
          type: string
          example: Guaranteed fast payment
        instantPayEnabled:
          type: boolean
        instantPayPaymentAccountId:
          type: string
        customPayinProvider:
          type: string
        tradeMode:
          $ref: '#/components/schemas/TransactionsSvcTradeMode'
      x-source-svc: transactions
    InstantPayProcessingStatus:
      type: string
      enum:
      - PENDING_IP_REPORT
      - IN_PROGRESS
      - FAILURE
      - SUCCESS
      x-source-svc: transactions
  securitySchemes:
    authSignature:
      type: apiKey
      name: x-signature
      in: header
    authToken:
      type: apiKey
      name: x-auth-token
      in: header
      description: Auth Token header for inter-service communication
x-organization: onboard
x-service-id: external-gateway
x-preserve-refs:
- '#/components/schemas/IntegrationProduct'
- '#/components/schemas/AdAppliedEscrowBalanceDto'
- '#/components/schemas/P2PWalletRecipient'
- '#/components/schemas/BankAccountRecipient'
- '#/components/schemas/MobileMoneyRecipient'
- '#/components/schemas/OrderEvent'
- '#/components/schemas/PaymentMethodEventAction'
- '#/components/schemas/PaymentMethodEventPayload'
- '#/components/schemas/TransactionServiceErrorCode'
- '#/components/schemas/ErrorCodes'