학습/Airtable 빠른 시작

Airtable에서 거래 환율 추적하기

Airtable 테이블과 예약 자동화로 지표성 FX 추정값을 갱신하면서 거래 시점의 원래 환율을 보존합니다.

ERexchangerate.dev·Sep 29, 2026·7분 읽기

원본 필드와 현재 필드를 분리하세요. Rate at transaction과 source, effective timestamp는 통화와 금액이 준비될 때 한 번 저장하고, Current rate와 메타데이터는 예약 자동화로 갱신합니다. 이후 시장 변동이 거래 이력을 덮어쓰지 않습니다.

핵심 요점
From, To, Amount, 원본 provenance, 현재 모니터링, 오류 필드를 명시적으로 만듭니다.
record-ready 자동화로 원래 환율과 provenance를 한 번 저장하고 다시 계산하지 않습니다.
At scheduled time 자동화로 현재 추정값과 source, effective_at을 갱신합니다.
0이나 최신처럼 보이는 값을 쓰지 말고 Sync status와 Sync error에 오류를 표시합니다.
Run a script는 Airtable Free에서 사용할 수 없으므로 도입 전에 플랜 한도를 확인합니다.

Transactions 테이블 만들기

Transactions 테이블에 From(한 줄 텍스트), To(한 줄 텍스트), Amount(숫자), Rate at transaction(숫자), Transaction converted(숫자), Transaction source, Transaction market session, Transaction effective at, Archived(체크박스), Current rate(숫자), Current converted(숫자), Source, Market session, Effective at, Checked at, Sync status, Sync error를 추가합니다. 날짜/시간 필드는 날짜/시간으로, 나머지 메타데이터와 상태는 한 줄 텍스트로 만듭니다. Needs FX refresh 뷰에서 Archived가 해제된 레코드만 필터링하고 Checked at을 빈 값 우선 오래된 순으로 정렬합니다.

두 환율 그룹은 의미가 다릅니다. Transaction *은 회계 또는 감사 스냅샷이고, 접두사 없는 현재 필드는 대시보드나 추정에 쓰는 새 관측값입니다. 현재 필드로 원본을 다시 쓰지 마세요.

거래 원래 환율 저장하기

When record matches conditions 트리거를 사용해 From, To, Amount가 채워지고 Rate at transaction이 비어 있을 때 실행합니다. Run a script에서 mode를 snapshot으로 설정하고 트리거 레코드의 recordId와 exchangerateApiKey Automation secret을 전달합니다. 스크립트는 input.secret으로 읽으므로 secret 권한이 없는 편집자도 값을 보지 않고 실행할 수 있습니다. 원본 환율이 비어 있을 때만 쓰며 재시도해도 원본 필드는 유지합니다.

HTTP request · latest ratecopy
GET https://api.exchangerate.dev/v1/latest/{From}?symbols={To}

Authorization: Bearer EXR_KEY_FROM_A_SERVER_SIDE_SECRET
Automation secret 사용하기
두 자동화의 Secrets에 exchangerateApiKey를 만들고 이름을 유지하세요. 값을 필드, URL, 공유 설명, 코드에 넣지 마세요.

예약으로 현재 추정값 갱신하기

두 번째 자동화를 At scheduled time으로 만들고 mode=refresh, 빈 recordId로 Needs FX refresh의 처음 25개를 처리합니다. 전체 Airtable 스크립트는 fetch를 최대 25회로 제한하고 50개 이하로 배치합니다. 25개 쌍을 매일 갱신하면 30일에 최대 750 API 요청입니다.

Refresh는 Current rate, Current converted, Source, Market session, Effective at, Checked at만 갱신하며 Transaction 필드는 건드리지 않습니다. HTTP 오류나 잘못된 응답은 Error로 표시하고 마지막 성공값을 유지합니다.

오류 표시하기

401은 Automation secret을, 429는 일정이나 계정 한도를, 없는 symbol은 잘못되거나 지원되지 않는 쌍을 확인해야 한다는 뜻입니다. 이전 Checked at을 유지하고 실패를 0 환율로 바꾸지 않습니다.

Airtable 플랜 한도 확인하기

Airtable의 Run a script 문서는 Automation secret과 편집자 보호를 설명합니다. 자동화 한도는 Free에서 Run a script를 사용할 수 없고 실패 실행도 계산된다고 설명합니다. 일일 갱신은 일일 기준값을 장중 시세로 바꾸지 않습니다.

지표 환율만 사용
추정, 보고서, 분석에 사용하세요. 결제나 규제 거래에는 담당 제공자의 실행 가능한 견적과 정산 기록을 사용해야 합니다.
ER
exchangerate.dev
FX 데이터를 사용하는 개발자를 위한 통합 가이드입니다.

계속 읽기

참고환율 API 빠른 시작읽기 TutorialZapier에서 환율 가져오기읽기 TutorialPower BI에 환율 불러오기읽기
더 많은 비교Fixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
학습ECB 기준환율 설명Next.js와 TypeScript에서 환율 사용하기Python으로 USD/IDR 환율 알림 만들기
실시간 환율EUR/USDGBP/USDUSD/JPY